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1.0 SCOPE 


The purpose of this document is to: 

CD Identify users of the GDPS Performance Data Base. 


(2^. Define procedures for operation of the GDPS. 

,, -''’Fiovide guidelines 
' '■ software. 


bllowed in maintenance of the GDPS 


C4) Define the output capabilities of the GDPS in support of external 
users of the system. 






'iii? 


4 


2.0 APPLICABLE DOCUMEICTS . 

In ^understanding this GDPS and its capabilities, the following documents are 
required:.. 

(1) GDPS Software Performance Specification Document (IBM No. 76W-0060) . 

(2) GDPS Hardware Performance Specification Document (7933190). ' 

(3) MSFC Data Systems Plan. . 

(4) Solar Heating and Cooling Instrumentation Installation Plan. 

(5) GDPS Development Plan, 

Documents applicable to each specific user group are referenced in subsequent 
sections of this document. 





3.0 ROLE OF GDPS IN SOLAR HEATING AITO COOLING PROGRA&I 

The GDPS, located at IBM’s FSD facility in Huntsville, Alabama, provides the 
resources required to assess the performance of solar heating and cooling systems 
installed at 60 remote sites. These remote sites consist of residential, commercial, 
government, and educational types of buildings , and the solar heating and cooling 
systems can be hot-water, space heating, cooling, and combinations thereof. The ’ 
instrumentation data associated with these systems will vary according to the appli- 
cation and must be collected, processed, and presented in a form which supports 
continuity of performance evaluation across all applications. In addition, d?,ta 
must be maintained for historical purposes and for detailed analysis. 

In supporting the overall program objectives, the CUPS satisfies the following 
functional requirements : 

Data Collection - The GDPS daily collects instrumentation data from all 
remote sites via standard voice-grade 1200 Baud telephone lines. In 
addition, non- instrumentation data available from tlSFG, ERDA, HUD, etc., 
which is needed in performing overall system evaluation, is collected 
via manual means. 

Data Processing - The GDPS accepts raw data, as collected by the data 
collection function, and perfoirms the data processing functions required 
to transform the raw data into processed information for use in system 
evaluation/analysis activities. The GDPS also provides the resources to 
maintain a performance evaluation data base, containing both raw data 
and processed information, for use in support of performance analysts. 

Data Archiving - To provide capability for detailed analyses of system 
performance and to maintain data for historical purposes, the GDPS provides 
the capabilities to archive data collected and processed during the 
program. Both raw data and processed data is retained on magnetic tape, 
and formal reports are archived in a library. 

Data Distribution - In addition to collection, processing, and archiving 
of data, the GDPS provides the essential function of distributing the 
data to the appropriate organizations. Distribution is in the form of 
printed reports, data plots, and magnetic tapes. 

Systems Analysis Simulation - An essential capability in assessing the 
performance of solar heating and cooling systems is the ability to predict 
performance for correlation with operational performance. The GDPS 
provides the resources needed in support of this simulation activity and 
provides capabilities for automated correlation of predicted and actual 
performance. 
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As shown in figure 3-l> the CDPS consists of three major elements - communication 
interface computer ^ central data processing computer y and performance evaluation 
data base. These three elements provide the capabilities re(juired to satisfy the 
functions mentioned above. 
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Pigure 3-1, Role of Central Data Processing System 







4.0 CDPS OPERATIONAL EKVIRONMEKT 

Tha CDPS must satisfy the processing and , user, support requi reme nts resulting 
from daily data collection from ail remote site^s. To provide data to ’raaiysts" by 
the beginning of first shift each day, an operations procedure has been established 
and is discussed in the following paragraphs. A pictorial representation of the 
operations flow is shown in Figure 4**1. 

4.1 DATA COLLECTION 


SDAS data collection will occur during the evening hours (beginning at 2000) . 

The collecting will continue until approximately 2330 (60 sites require approximate- 
ly 3.5 hours) and upon completion, will be transferred via data link to the S/370- 
145 (requires 30 seconds). Computer operator intervention will be performed at 
the start of data collection time period to initiate the System 7 software,' During 
the data collection time period, the communication interface computer console will 
be monitored for indications of telecommunications progress in contacting and 
receiving data from the SDAS equipment. In the event of communications difficulties, 
effort •will be undertaken to resolve the problem during the hours dedicated to data 
collection. The communication operations personnel will be guided in the problem 
resolution by directions from the S/7 software analyst. The operator will, as 
required, interface with the MSEC Telecommunications Systems Status Center (TSSC) for 
resolution of communications difficulties. 

4.2 DATA PROCESSING 


Data processing on the host computer will occur between the hours of midnight 
and 0700 each day in order to provide error reports and summary reports and perfor- 
mance reports for SIMS 'analysts at the beginning of first shift (0800). The Input 
Processing portion of the CDPS software system will be executed, upon completion of 
data eoimnunication and retrieval by the Communication Interface computer, and will 
process the forr^arded data from the System/7. All processed data containing no 
errors will be converted into engineering units, performance calculations performed, 
and data made ready for Insertion into the performance evaluation data bank. Errors 
encountered during processing Tri.ll be flagged such that erroneous data will not be 
entered into the data base, and error messages /reports will be provided for 
analysts. 

4.3 DATA Bi^E PROGES S INC 

Upon completipa of the Input Processing phase, the. Data Base/User. Support soft- 
ware T7111 be executed in a batch environment under control of computer operations 
personnel. This processing will be accbmplished in a manner to satisfy data avail- 
ability requirements and output distributiori. 
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Figure 4- 1. Summary Chart of COPS Daily Operations 


To ensute timely completion, a high priority will be assigned to the processing 
of input data and will be monitored by operations personnel. If conflicts occur, 
the processing will be assigned the highest priority and will override any other 
processing. 

Archiving of data will be provided through the use of software within the host 
computer. Raw data, processed data, and performance reports will be maintained 
within the computing facility and will be distributed as required for analysis/ 
storage. 

4.4 USER SUPPORT 


User support Will require that the data base management software allow ready 
access to the data base contents via local terminals and support batch job access 
to data for special analysis activities. When the IBM performance analyst requires 
a terminal capability to access the performance evaluation data base the computer 
operations personnel will, upon request, initiate the terminal processing capability 
of the NIPS software. 

4.5 UATA BASE MINTEHAHCE ^ 

In addition to the daily scheduled updating of the Performance Evaluation Data 
Base with input from the Input Processing Software there .will be the capability to 
perform selected maintenance on an as required basis. 

4.5.1 Error Correction 


Error conditions on data fields within the data base corrected during first 
shift will be entered into the data base via local terminals (for small data volume) 
or vi.a batch job submission. Upon completion of error correction, the performance 
evaluation data within the data base will be formatted and bitten to magnetic tape 
for transfer to the MSEC Solar Energy Data Base. 

4.5.2 Non- Instrumentation Data Handling 

Data elements to be added to the data base which are not gathered by the SDAS 
and processed in the CDPS, such as site location, site equipment availability, 
weather data, etc. , will be entered into the data base via terminal or batch mode 
using the NIPS File Maintenance capability. This will allow for text type data 
to become part of the data base and available for reporting purposes. 





5 . 0 DEFINITION OF CDP S USERS 


This section provides a brief description of GDPS users and their functions. 
Detailed information about user functions can be found in subsequent sections of 
this document . 


GDPS Software Support Personnel - Responsible for maintenance of GDPS 
Software and for continual evaluation of softTi^are performance during 
daily operations. Includes the following support personnel: 


( 2 ) 

(3) 


Communication Interface Programmer(s) /Analyst 


Input Processing Programmer (s) /Analyst 


Data Base Maintenance ProgrammerCs) /Analyst 


Computer Operations Support Personnel - Responsible for; 

(1) Operation of the GDPS configurations during daily data 
collection and processing 

(2) Maintenance of archived/backup data on magnetic tape 

(3) Production of daily/monthly/ seasonal /annual reports as 
requested by Report Distribution Personnel. 


Site Performance Analysts - Responsible for: 

(1) Providing site descriptive data for establishing data base 
entry for site. 

(2) Review/ ana lyse daily reports produced from operational data. 

(3) Provide calibration/conversion data for processing of operational 
data. 


Data Request Coordinators - Responsible for: 

(1) Interface with internal/external GDPS users 

(2) Coordinate activities required to satisfy user requests 

(3) Coordinate changes to GDPS hardware /software to ensure that 
requested capabilities are achieved 
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6.0 GDPS SOFTWAI^ USER GUIDELIHES 

As was stated in Section 5, the GDPS software users will consist of a Gom- 
munication Interface Progrannnei '.) /Analyst, and Input Processing Programmer (s)/ 
Analyst, and a Data Base Mainteiiance Pro grammerCs) /Analyst. This section of the 
user's manual addresses the user information required in accomplishing those Pro- 
grammer/Analyst functions . 

t 

6.1 COMMUHIGATION INTERFACE PROGRAMMER(s) /ANALYST USER GUIDELIMES 

User guidelines for the Communication Interface Programmer (s) /Analyst have been 
structured to address each area of responsibility. These areas are: 

(1) Software maintenance 

(2) Generation of S/7 load librairy 

(3) Communication error analysis 

(4) Remote site troubleshooting 

(5) Site directory maintenance 

(6) System/7 - S/370-145 Interface 

The procedures /guidelines to be used in performing these tasks are discussed in the 
following paragraphs. 

6.1.1 A.pplicable Documents 

Document Name 

IBM System/7 Teleprocessing Multiplexer (GA34-1510-1) 

IBM System/7 Functional Characteristics (GA34-0003-6) 

IBM System/7 Sensor Based Control Adapter (3BCA) General Information 
Manual C6A34-1512-0) 

IBM System/7 7431 Serial Printer (SY34-0520-1) 

Data A-uxiliary Set 301 (Automatic Calling Unit) Interface 
Specification (Western Electric) 

Data Set 202C - Type Reference Guide (Western Electric) 

Li page Question Forms and Messages (SH2D-9535) 

yij' POOR QUAIZPK 
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IBM Systeni/7 Operator's Guide (6A34-0007-4) 

A Guide to Host AP6/7 Operations (SH20*'9S03“2) 

The AP6/7 Encyclopedia (SH20-9510-1) 

MTMT Operation Manual 
6 . 1 . 2 Software Maintenance 

The Communication Interface Software Source Statements, written in APG/7 
language are resident on disk on the S/370-145 Computer, The disk data set 
containing the operational program is named PH7LG31A. SIMS and is accessible 
via ilTMT within the IBM Huntsville Facility. The APG/7 compiler is resident 
within the S/ 3 7 0-145. The procedures to be used in maintaining the communication 
interface software are described below. 

The overall software structure is shown in figure 6-1 and is comprised of a 
nucleus and application program. 

6.1. 2.1 Application Program Source Statement Maintenance 

The Source Statements for the communication interface software must be retained 
on Disk Data Set SYSL.SYS7.MACLIB. This data set must be written to a temporary file 
for dating and testing prior to release for operational use. Source statements and 
update transactions tor previous released versions must be written to magnetic tape 
and retained for record purposes and/or recovery in the event of loss of the 
operational program statements on disk. Upon completion of testing of changes, 
the new source statements must be written to the operational Disk Data Set and a^ ' 
date of replacement applied to the Data Set for reference purposes. This procedure 
is pictorially shown in figure 6-2. 

6. 1.2. 2 Nucleus Generation 


The Nucleus Program is comprised of System Programs provided by the APG/7 
compiler and is created on the S/370-145 through a corapilation/iink adit activity. 
The communication interface software package utilizes several separate nucleus 
programs: 


Function 


Name 


Operational Site Data Gollectlon W75DCC 


Support of Site Data Collection 
Manual. - Testing, .of Sites ■ 

Support to s/;3t0“l45 - 


m EXEC - 
N7 TEST 


Brocedutes for geheEafcion..of a System/? nucleus are shown, in 

to be provided by the nucleus qan be selected via 


S-3:, The 





1 


) 


U1 




figure 6- 1. Communications interface Software Qesign 






s/7 

TESTING 


NEW 

program 


OLD 

PROGRAM 


S/370-145 


Figure 6-2. Application Pfograni Mslntenapce 
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Figur*6~3. Nuc/eas Generation Procedure 











6. 1.2. 3 Application Programs Compilation 

Application Program Compilation is performed on the S/370-145 utilizing the 
AP6/7 compiler. Input to the compiler consists of the source statements resident 
on the S/370-145 disk. Output of the compiler is a program listing and a load 
module for the Systera/7 computer. Input and output parameters are specified ■' ia 
Job Control Language (JCL) Statements. A representative JCL setup for compiling 
an application procedure is found in "A Guide to Host APG/7 Operations.” 

6. 1.2. 4 Nucleus Compilation 

Nucleus capabilities are selected via control cards enclosed within the JCL 
Statements. Information regarding nucleus generation is found in IBM documents 
"AFG/7 Question Forms and Messages" and "A Guide to Host APG/7 Operations. 


6. 1.2. 5 System/ 7 Load Module Creation 

Systera/7 Load Modules are created on the S/370-145 through use of the APG/7 
link editor. Input to the link editor consists of the nucleus program load module 
and the application programs load modules. Output of the link editor is a load 
module which contains all programs required to execute on the System/ 7 xfith all 
program linkages resolved. Details of the module creation procedure are given 
in "A Guide to Host APG/7 Operations.” 


6.1.3 System/? Load Library Generation 

The System/7 load library will be resident on the System/7 disk and will be 
comprised of the System/? load modules generated on the S/370-145. To generate the 
library, the load modules must be transferred from the S/370-145 to the System/ 7 
via the Sensor Based Control Adapter (SBCA) , catalogued on the System/7, and written 
to Systera/7 disk. 


The procedures to be followed in generation of the load library are given 

below: 


s/370-145 Action 
EXECUTE Program 'SBCOPROG’ 

VIA 

5028 

STOP 'S3CUPRDG' 


System/ 7 Action 

IPL S/7 to Fixed Disk (F4) 

LOAD Program 'PGMLOAD' 

REPLY *$$SYS7ID’ 

REPLY ’.SIM' 

REPLY '[PROGRAil NAME DESIRED], R4' 
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6,1.4 Comunication Error Analysis 


The "Conimunicatiori. Log Report" provides the basic information, used in 
troubleshooting of coiaaunication problems, A summary of the error conditions, 
detected by the software is created whenever communication is attempted with a 
remote site by the S/7 operational program. Table 6.0 contains a description 
of these communication errors. 


6.1.5 Remote Site Troubleshooting 

The "Test SDAS Interface" software within the System/7 exists within the 
load library as member "W7TEST". If the Site Performance Analyst determines 
that manual troubleshooting of a remote site is required, the "Test SDAS Inter- 
face" software must be loaded from the load library. The procedure to be . 
followed in exercising the software is described below; 


(1) Via 5028 Enter 'L W7TEST' 

(2) After reply printed indicating program loaded, enter present time as 

YY,DDD,HH,MM,SS 
where: YY = Year 

DDD = Numeric day of year 
HH “ Hour (24 hour clock) 

MM = Minute 
SS = Second 

Enter ’TSA’ 

(3) Respond to printed command options as desired. 


COMMAND 


DESIGNATION 


'OPEN' 

'CLOS' 

'DIAL' 

'REDF' 

'DISC 

'REWD' 

'RDCN' 

'DRWD' 

'REIN' 

'RSST' 

'CALL* 

'CALT' 

'CALS' 

'EXIT' 


Open command to TPMM 
Close command to TPMM 
Dial command to TPMM 

Read configuration and End of File to Site 

Disconnect to site 

Rewind tape to site 

Read configuration to site 

Disconnect and Rewind to site 

Reinitialize to site 

Read storage table to site 

Call over local line to site 

Call over tie line to site 

Call using site direction 

Exit test execution 


Note: CALL, CALT, and CALS performs the CLOS, OPEN 

and DIAL functions automatically. 

(4) Analyze errors (see Table 6.0) encountered during communications. 


(5) Print received data for detailed analysis. -• 
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Table 6.0 


TPMM ERROR 
CODES 


DESCRIPTION OF ERROR 


* 2 
* 3 
4 


* 5 

* 6 

7 


8 

9 

15 

16 


I/O Parameter list busy 
Invalid control word 
Data set check 

o Loss of Data Set Ready during a read 
o Loss of Carrier Detect during a read 
0 Loss of Clear to Send during a write 
o ACU not ready during a dial 

Line closed 

Invalid line number 

Data overrun 

0 Character interrupt occurred before 
previous character serviced 

System/? XIO error 

Timeout between characters 

Timeout (no reply) 

BCH error in command frame 


*17 


I/O area overrun 


*32 


Invalid buffer count 


34 Data set not ready 

40 BCH errors detected in data 


*Software Error - Program Stop 


System/? SDAS Communication Error Definitions 
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6.1.6 Site Directory Maintenance 

The System/7 Site Directory contains the information needed to automatically 
perform data collection functions and to transmit data to the S/370-145 for 
subsequent processing. Maintenance of the Site Directory consists of addition and/ 
or deletion of entries as remote sites are brought on-line or terminated. In 
addition, the capability to print the contents of the Site Directory is provided. 
The software to support these maintenance functions are the Site Directory update 
program and the Site Directory print program. These programs and associated 
nucleus are contained within the load library and are executed as described below: 


CD Via 5028 


Enter ’L W7EXEC' 


(2) After reply printed indicating program loaded enter present time. 


(3) Print Site Directory; 


Enter 'DSD' 


Reply 'Y* if all sites are desired to be printed. Reply 'N' is only 
selected sites are to be printed. 

Reply 'd' where d is site number of site to be printed. 


(4) Update Site Directory 


Enter 'UPB" 


Reply 'm' where m is desired site number to be updated. 

Note: If a new site is to be added to the directory, the site number 

must be the next number past the last site number entry. 

Reply 'y* if the telephone number is to be updated. 


Reply ' nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn ' 


Where n is the formatted 32 digit telephone number. 
Information regarding the correct format for dial 
digits can be found in "IBM System/7 Teleprocessing 
Multiplexer” 
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6.1.7 System/7 S/370-145 Interface 


The software utilized within, the Systm/7 to communicate with the S/370-145 
consists of several different programs dependent upon the type of transfer. Table 
6-1 contains a correls.tion of data transfer requirements and corresponding 
System/7 software. 


Table 6.1 - 



System/7 load module transfer is used in creation of the System/7 Load 
Library. Procedures for operation are discussed in paragraph 6.1.3. 

The **Host Forward Store” software is contained within the load library and 
provides the capabilities to format data collected from remote sites and transfer 
the data to the S/370-145 for processing. Procedures for execution of this soft- 
ware and error conditions /corrective actions are described below; 

(1) Insure that ’SBCU PROG* has been, initiated in Host 

(2) Via 5023 IPL from System/7 fixed disk 

(3) After System/7 prints >, enter $L] 

(4) After System/7 prints ’PGM C^^AME, lODA) : ' , enter ’HFS’ 

(5) After System/7 prints ’SCCU PROG STARTED OK HOST?’, enter *Y* 

(6) Upon completion of transfer of data, System/7 will print 
*HFS ENDED 'DATE/TIME’ 


21 



6.2 IMPUT PROCESSIMG PRQGRAMMES/AMALYST tiSER GPIDEEIKES 

The Input Processing Prograimner/ Analyst will hava the- following areas of 
responsibility ; 

Cl) Source Statement Maintenance 


C2) Input Processing Report Analysis 
(3) Job Control Language (JCL) Statements 


(4) Maintenance of the Site Data Description File 


The user guidelines associated with the above areas of responsibility are 
discussed In subsequent paragraphs. 

6.2^1 Applicable PbciiE^ents . 

The following documents are required in order to perform the functions of the 
Input Processing Programmer/ Analyst . 

Document Name Numbor 

CDPS Software Performance Specification IBM No. 7933251 

CDPS Software Design Document 

PL/I Reference Manual " IBM GC2^-8201 

PL/I Programmer's Gtxide 
JCL Manual 

OS ITtilities Manual IBM GC28-6586 


6*2,2 Software Maintenance 

As shown in figure 6.2-1, the Input Processing Software consists, of five 
elements (site date description utility, site data acceptance, raw data processing, 
merge and summary, and history). The source statementsV (except for the Site 
Data Acceptance Module) written in PL/I language, reside on disk within the S/370-145 
in partitioned data set ''SIMSIPS.SODRGE.'' The pompiler utilized in creation- of 1^ 
modules for the Input Processing Software is the resident Pl/I compiler within the 
S/370-145. 

The load modules for the input processing sof tware will be "rahihtainei: bn disk 
for use in processing of incoming data. Backup versions of the load modules will 
be saved on magnetic tape for backup in the event Of loss of data on disk. 
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IBM GC28-6594 
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Updating of the Source Stateaents and creation of new operational load modules 
will be controlled by procedures as specified in the GDPS Development Plan. 

Changes to source must be^ approved prior to implementationj and utilization of 
lieW bperational load modules ^11 occur only after testing of changes has been 
comp letedi Previous versions of both source and load modules, with identification 
of changes, will be maintained. 

Source update can be accomplished through either the HTMT update capability or 
the use of the lEBUPDAIE; capability. All transactions made to create a new input 
processing load module must be recorded and maintained. 

The compilation of input processing software will be controlled via Job Control 
Language (JGL) s tataaents , Set-ups for compilation and link edit of the input 
processing software are shown in figure 6.2-2. 

A significant portion of Input Processing Software maintenance will be the 
implementation of performance evaluation equations supplied by performance analysts. 
The equations will be site dependent. 

6>2..3 Input Processing Report Analysis 

The input processing softoare produces the follot-Ting reports during its 
operational utilization; 

■ Raw Data Processing Reports 

e Merge and Summary Reports 

a History Reports 

Description of these reports and actions retjuired of the programmer/analyst 
are discussed below: 

6. 2, 3.1 Raw Data Processing Analyses 

Raw Data Processing provides the following; 

e Varying levels of site raw data processing summaries (see 
figure 6.2-3), 

a An overall raw data processing summary (see figure 6,2-4), 

a Detail record prints (see figure 6.2-5). 

a Possibly, error messages for sites for which site raw data 
.pxo cessing summaries were not req,uested. These will be 
interspersed with the site summary reports. 

The detail included within these reports is under control of the Performance 
Analyst through input to the software. 

A list of error, messages and possible causes dr corrective actions is provided 
•in table 6.2-li ■’ 



Raw Data Processing Pro^am 


7/vEXeC PLIFC,"' r •• •-. 
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Merge and Summary Program 
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Figure 6.2-2, Setups to Compile and Link input Processing Software (Page 1 of 2} 
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Figure 6.2-2. Sewps to Compile and Link input Processing Software (Page 2 of 2} 
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Table 6.2- 1. Raw Data Processing Error Messages (Sheetl of 6} 



Message: NO SITE DATA DESCRIPTION RECORD FOR SITE . DATA FOR THIS 

SITE BYPASSED. 

Error Level: 12 Subroutine: IP3RAW (Main) 

Explanation: Raw data with a site id for x^hich there is no record in the 

Site Data Description file. Either the raw data is wrong, or 
the Site Data Information for the site must be added to the 
Site Data Description file. 


Message: SITE IS A SITE WITH NO PREVIOUS DATA. 

Error Level: None Subroutine: IPSRAW (Main) 


Explanation: No record for the site x^as found in the continuity file. This 

means that the current batch of raxv data contains the first 
operational data collected from the site. 


Message: LOST IN RAW FILE. SITE ID RECORD HAS V/RONG FILL PROCESSING 

STOPPED. 

Error Level: 16 Subroutine; IPSRAW (Main) 

Explanation; Raw data has x^rong format or some data is missing. Consult 
x^ith System/7 programmers for possible problem explanation. 
(Site id record content is printed.) 


Message; PECULIAR VALUES IN TIME OF SITE ID. DATA PROCESSING FOR THE SITE 
WILL BE BYPASSED. PROCESSING FOR OTHER SITES LULL BE ATTEMPTED. 

Errov Level: 12 Subroutine: IPSRAW (Main) 

Explanation; Either System/7 put bad values in Site id record or this is 
not a site id record. If record also has bad fill data or 
bad counters it is probably not an id record. Consult with 
System/ 7 programmers for possible problem explanation. (Site 
id record content is printed.) 


Message; B.AD VALUE (S) IN COUNTERS OF SITE ID RECORD. PROCESSING STOPPED. 

Error Level: 16 Subroutine: IFSR.AW (Main) 

E:<planation: Either System/7 put bad value (s) in Site id record or this is 

not an id record. If record also has bad fill data or bad 
time values it is probably not an id' record. Consult with 
System/7 programmers for possible error explanation. (Site 
id record content is printed.) 


URIGINAL PA-GBJS 

OE EOOB. QUALO^ 
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Ta6/e 6M- 1. Raw Data Processing Error Messages (Sheet 2 of 6} 


Message; HIGHEST SEVERITY LEVEL, 

Error Level: Not applicable Subroutine; IPSRAW (Main) 

Explanation: If 16, terminal error encountered. If 12, processing failed 

for one or more sites. If 10, one or more data blocks 
rejected. If 8, one or more scans rejected. If 4, one or 
more individual variable readings rejected. If 0, no data 
rej ected. 


Message: UNEXPECTED END OF FILE OF RAW DATA MILE SEPARATING RAW DATA OF 

SITE INTO DATA AND FUG STREAMS. 

Error Level: 16 Subroutine: STREAM 

Explanation: Site id record must have a bad value in its counters or some 

raw data has been lo?:t. Consult with System/7 programmers 
for possible error explanation. 


Message; SCANSEP; END OF FILE READING DATAFIL. PROCESSING STOPPED FOR 
SITE 

Error Level: 12 Subroutine: SCANSEP 

Explanation: End-of-site indication not found in the data records' for the 

site. If BCH error count for the site was not zero then 
probably a noise problem made an End-of-block or End-of-site 
unrecognizable . 


Message: SCANSEP. END OF FILE READING FUGFIL, PROCESSING STOPPED FOR 

SITE 

Error Level: 12 Subroutine: SCANSEP 

Explanation: Normally accompanies an ’END OF FILE READING D.ATAFIL' message 

and is part of the same problem. 


Message: SCANSEP. A COMMAND FRAME HAS ILLEGAI. CODE AND NO BCH ERROR. PRO- 
CESSING STOPPED FOR SITE ID 

Error Level; 12 Subroutine; SCANSEP 

Explanation: Either raw data has wrong format or the scan separation 

routine has gotten lost processing noisy data. Look at site 
BCH error count and cons'ult with System/7 programmer for 
problem explanation. 
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fable S.2- 1, Raw Data Processing Error Messages (Sheet 3 of 6) 




Table 6.2- 1. Raw Data Processing Error Messages (Sheet 4 of 6) 


Message; SCANSEP: COMMAND WITH BGH ERROR AND ILLEGAL CODE ASSUMED TO BE 

END OF SITE, SITE ID - 

Error Level; 10 Subroutine; SCANSEP 

Explanation: Similar to BCH error in connnand xvith End-of-site command code. 

Message; SCANSEP: BCH ERROR IN END OF BLOCK OR START OF SCAN. DECODED AS 

END OF BLOCK, SITE ID = 

Error Level: 8 Subroutine: SCANSEP 

Explanation: Trying to correctly process noisy data. Six or more characters 

of *FF’ imply End-of -block. If wrong probably will get lost in 
the scan separation process. 

Message: SCANSEP: BCH ERROR IN END OF BLOCK OR START OF SCAN DECODED AS 

START OP SCAJS AND SCAN DROPPED. SITE ID = 

Error Level; 8 Subroutine; SCANSEP 

Explanation: Trying to process noisy data. If data does not contain at 

least 6 bytes of *FF* as in .End-of-Block it is treated as 
Start-of-Scan. The scan is dropped because of uncertain 
time. 

Message: CNVTEST; BAD SCAN POINTER FOR SITE ~ PROCESSING FOR 

SITE STOPPED. 

Error Level: 12 Subroutine: CNVTEST 

Explanation: Bad information in the Site Data Description file. Change 

values on the Site Data Information form and/or change the 
Site Data Description Utility. 

Message’! CNVTEST: BAD NIPS POINTER FOR SITE . ! PROCESSING FOR 

SITE STOPPED. 

Error Level: 12 Subroutine: CNVTEST 

Explanation: Bad information in the Site Data Description file. Change 

values on the Site Data Information form and/or change the 
Sice Data Description Utility. 
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Table 6,2-1 , Raw Data Processing Error Messages {Sheet 5 of Sf 


Message: IN CNVTEST HAVE SITE ID MISMATCH. 

SITE-DATA-INFO. SITE-ID = SCAN SITE-ID =» 

NIPS-INPUT. SITE-ID = PROCESSING TERMINATED. 


Error Level : 16 


Subroutine: CNVTEST 


Explanation: Should never happen. Look for a software problem. 


Message: CNVTEST; ILLEGAL CONVERSION TYPE IN SITE DATA INFO. PROCESSING 

STOPPED FOR SITE ID 


Error Level : 12 


Subroutine: CNVTEST 


Explanation: Bad information in the Site Data Description file. Change 

values on the Site Data Information form and/or change the 
Site Data Description Utility. 


Message: VARIAhi.£ _ 

MINIMUM =. 


.OUT OF LIMITS AT TIME 

. MAXIMUM = VALUE =. 


Error Level: None 


Subroutine: CNVTEST 


Explanation: Engineering units value of variable is outside of perfonnance 

analyst specified limits. 


Messag^ VARIABLE 


Error Level: None 


HAS BCH ERROR AT TBIE , 


Subroutine: CNVTEST 


Explanation: A BCH flag error affects the portion of the raw data from 

x^hich the variables data was extracted. The value could be 
wrong . 


Message: VARIABLE 


Error Level: None 


CHANGED TOO FAST AT TIME 


Subroutine: CNVTEST 


Explanation: Change between successive values of a variable exceeds per- 

formance analyst specified limits. 


Message; VARIABIB. 
Error Level: 4 


.REJECTED AT TIME. 


Subroutine: CNVTEST 


Explanation: Variable failed two or more tests (out— of— limits , BCH error, 

or changing-too-fast) and value x^as rejected. 
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Table 6.2-1 . Raw Data Pntcessing Error Messages {Sheet 6 of 6} 


Message: CHVTEST; BAD OP CODE IN ENGINEER EQUATIONS. PROCESSING STOPPED 

FOR SITE 

Error Level: 12 Subroutine: CNVTEST 

Explanation: Bad computed variable equation in Site Data Description file. 

Change data on Site Data Information form and/or change the 
Site Data Description Utility. 


Message: VARIABLE HAS CONSTANT VALUE 

Error Level: None • Subroutine: CNVTEST 

Explanation: A variable which performance analyst has specified must change 

had a constant value throughout one batch of raw input. In- 
dicates a possible problem in the site data collection hard- 
ware . 





Table 6,2-2. Merge and Summary Error Messages (Sheet 1 of 2) 


Message: SORT COMPLETION CODE 

Subroutine: MERGSUM (Main) prints message to indicate return code from sort 

routine. 

Explanation: Completion code 0 means successful. Any other code means not 
successful. Examine sort messages for problem indication. 


Message: MERGE SELECT COMPLETION CODE 

Subroutine: liERGSUM (Main) prints message to indicate return code from Merge 

Select routine. 

Explanation: Completion code 0 means successful. Any other code means not 
successful. A previous message should indicate reason for 
failure . 


Message: GENERATE HOURLY COMPLETION CODE 

Subroutine: MERGSUM (Main) prints message to indicate return code from 

Generate Hourly Records routine. 

Explanation: Completion code 0 means successful. Any other code means not 
successful. A previous message should indicate reason for 
failure. 


Message: GENERATE DAILY COMPLETION CODE 

Subroutine; MERGSUM (Main) prints message to indicate return code from 
Generate Daily Records routine. 

Explanation: Completion code 0 means successful. Any other code means not 
Successful. A previous message should indicate reason for 
failure. 


Message; TOTAL MERGE & S^fi-IARY COMPLETION CODE 

Subroutine: MERGSUM (Main) 

Explanation; Completion code zero means successful. Any other code means not 
successful. A previous message should Indicate reason for 
failure. 


Message: FOR SITE A RECORD IN ADDED DETAIL RECS HAS TIMS<- 

THE TIME OF THE LAST OLD DETAIL RECORD FOR THE SITE. 

Subroutine: MERGSEL 

Explanation: Incorrect job setup.. 
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Table S.2-2. Merge and Summary Error Messages (Sheet 2 of 2) 


Message; FOR SITE A HISTORICAL DAILY RECORD HAS TIME 

GREATER THAN HISTORY TIME 

Subroutine: GENDALY 

Explanation: Incorrect job setup. 

Message: OLD DETAIL RECORD FILE HAS imONG LEVElT. PROCESSING STOPPED^ 

Subroutine: MERGSEL 

Explanation; Incorrect job setup. Old detail record file is wrong. 

Message: ADDED DETAIL RECORD FILE HAS WRONG LEVEL. PROCESSING STOPPED. 

Subroutine ; MERGSEL 

Explanation; Incorrect job setup. Added detail record file is wrong. 

(SOETIN) 

Message ; SELECTED DETAIL RECORDS USED TO GENERATE HOURLY RECORDS HAVE 
roONG LEVEL. PROCESSING STOPPED. 

Subroutine: GENHRLY 

Explanation: Either incorrect job setup or a software problem in MERGSEL or 
GENHRLY. 

HOURLY RECORDS USED TO GENERATE DAILY RECORDS HAVE mONG LEVEL. 
PROCESSING STOPPED. 

Subroutine : GENDALY 

Explanation; Either incorrect job setup or a software problem in GENHRLY or 
GENDALY. 

Message: HISTORICAL DAILY RECORDS HAVE WRONG LEVEL. PROCESSING STOPPED. 

S ub routine : GENDALY 

Explanation: Incorrect job setup. Also could be caused by a software problem 
in the History Program Generate Daily Records Routine, 

I 
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Figure 6,2-3. Sample Raw Data Processing Site Summary Report 
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Figure 6.2-4. Sample Raw Data Processing Overall Suwnary Report 


6. 2. 3. 2 Merge and Sunaiary Reports 

The merge and summary process generates the following reports: 

e A summary of completion codes for the various merge and summary 
phases (see figure 6.2~6) 

e A detail record report (see figure 6.2-7) 

e An hourly record report (see figure 6.2-8) 

e A daily record report (see figure 6.2-9) 

Deflidtlon of error messages and possible causes or corrective actions is 
shown In table 6.2-2. 


6. 2. 3. 3 History Processing Reports 

History processing generates the following reports: 

• A page of completion codes for history program phases (see figure 

6 . 2 - 10 ) 

e A detail record report (see figure 6 ’.’2-11) 
e An hourly record report (see figure 6.2-12) 
e A dally record report (see figure 6.2-13) 

Definition of completion codes /error messages and explanations is given 
In table 6.2-3. 

- 2 . 4 Job Control Language (JCL) Statements 

The Input Processing Programmer /Analyst must provide the Job Control Language 
statements (JCL) required for correct execution of the software in the operational 
onvironment. Figures 6.2-14 through 6.2-16 provide representative JCL procedures 
C?ROCS) for execution of each of the regularly scheduled Input processing software 
production jobs. 


6. 2.4.1 Nightly IPS Production Run 


This run, which Is executed every night, includes Raw Data Processing, Merge 
and Summary, and saving several disk files on tape. 
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Tabie 6^-X History Pmgnm Error Message (Sheet 1 of 31 


Message: DETAIL RECOIJD SELECT COMPLETION CODE 

Subroutine: HISTORY (Main) prints message to indicate return code from 

routine HSELECT . 

Explanation: Completion code 0 means successful. Any other code means not 
successful, in which case a previous message should indicate a 
reason for the failure. 


Message: GENERATE EOUM,Y RECORDS COMPLETION CODE ______ 

Subroutine: HISTORY (Main) prints massage to indicate ref.’.tn code from 

routine GENHRLY. 

Explanation: Completion code 0 means successful. Any other code means not 
successful, in which case a previous message should indicate a 
reason for the failure. 


Message; GENlRATE DAILY RECORDS COMPLETION CODE_ 

Subroutine; HISTORY (Main) prints message to indicate return code from 
routine 6EtH)ALY. 

Explanation: Completion code 0 means successful. Any other code means not 
successful, in which case a previous message should indicate a 
reason for the failure. 


Message: TOTAL HISTORY PROGRAM COMPLETION CODE 

Subroutine: HISTORY (Main) 

Explanation: Completion code 0 means successful. Any other code means not 
successful and a previous message should indicate a reason for 
the failure. 


Message: CONVERSION ERROR 

Subroutine: HISTORY (Main) 

Explanation: Most probable cause is faulty data or no data in the execution 
parameter. Make sure execution parameter begins with six 
numeric characters. 


CRECEDINQ PAGE BLANK NOntfiM 
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r«M»6L2^3l H6itof^PrognmErrorM»$mgt(Slmt2of3t 


Message: FARM CONTAIKS IMPOSSIBLE HISTORY BATE 

Subroutine: HISTORY (Main) 

Explanation: Parameter must start with six charaGters specifying Year, Month, 
and Last Day in Month of the month being historled. Correct 
FARM and rerun. 

Message: FARM ISPUt FDR NEW HISTORY TIME IS HOT > OLD HISTORY TIME. OLD 

HISTORY TIME IS ■■ 

Subroutine: HISTORY (Main) 

Explanation: Trying to run without advancing the history date. Either FARM 
is wrong or the wrong data is in the History Date file. 

iWPTff for mew HtStORY TT^ WnT < RTra TTMR 1 

Subroutine: HISTORY (Main) 

Explanation: Bad execution parameter (FARM) or a bad system clock time. 
Message: INPUT DETAIL RECORDS HAVE WRONG LEVEli PROCESSIHC STOPPED. ^ 

Subroutine: HSELECT 

Explanation: Incorrect job setup. Using wrong data in old detail record file. 

Message: SELECTED DETAIL RECORDS USED TO GENERAf 1 HOURLY RECORDS HAVE WRONG 

LEVEL. PROCESSING STOPPED. 

Subroutine: GEtHiRLY 

Explanation: Either incorrect Job setup or a software problem in HISTORY or 
HSELECT. 

Message: OLD HISTORICAL DAILY RECORDS HAVE WRONG LEVEL, PROCESSING STOPPED. 

Subroutine : GENDALY 

Explanation: Incorrect Job setup. Using wrong data for old historical dally 

file (HSTDALY). 
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Tabit 6^-X History Prograrn Error Message (Shaet 3 of 3f 


Message: HOURLY RECORDS USED TO GENERATE DAILY RECORDS HAVE WRONG LEVEL. 

PROCESSING STOPPED. 

Subroutine: GENDALY 

Explanation: Incorrect job setup or a software error in HISTORY or GENHRLY. 

Message : FOR SITE ^ AN OLD HISTORY DAILY RECORD HAS TIME 

THE OLD HISTORY TIME. 

Subroutine: GENDALY 

Explanation: Incorrect job setup. The old history records (in file HSTDALY) 
and the old history time do not agree. Perhaps a run was 
aborted and data sets not restored correctly. 


Message; AN ADDED DAILY RECORD HAS TIME. OUTSIDE THE CORRECT RANGE. 

Subroutine : GENDALY 

Explanation: A software problen in record selection criteria, storing time 
in generated records, or in the test itself. 
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Tmi STORY ^«XSC^' P GK=S IMSHI Sir RES I 150K'J T 

Y//STI PLI8 QD DSM= SI MS r^ s , LD4 DLIS 1 0 IS P=S HP ■■■;.:^ ' - ■■ •■ r,-. 

/•/jtctcti rtft nc v=c TMc TOC jt cxr.\TC^ n rcn - f n ri\_ (('rirovsiv, ^ 


I Luu I L» t, liOi'i—o i ro iro »L< r; » -i 1 1_ »n i d {»j n. i . N f n t 

DIS P=( NF: W , CATLG) t L A3 HL= { 1, S L » XP DT = s 5365 ) , 

~ T'.'.'^ n'_rrrr'rT?»'TnrjTrTTV"TTrr''r*T^ 'rmr pivn/'c' ■ t'.v Trr::;-rr^'rv,'\“r~' ~‘ — r~* ' 


i ‘^/DToryaLr "D o"!TSN D n 

' // VOL=StR=3330Q^,5PAC2 = tT3K,5] t 
1 // CCB=tRECFM=.-3, LRF:L=355 f3L<SI ^*>6393) 

1 //5YSPSIMT DO •SYSD0T=A,U'Jir = rSYSCUT,2) , SPttCr 

b~77 cci5={R ?rFw=VBTrLRrcu‘=r3’ r ;fog r ?;r:= 3 szo r 

■ //R£P Tr IL CO SYSOUT ==-\ ,UMIT=C S YSOUT? 2) i S P AQ> 


r^335^ 


o,r== (3520,(10,5) ) 

^ ^ 1 , ^ 

ax 3520,(10,5 )U 


-tlU y Av"-^ 1 7 V-. r T -r* * ^ w „ * 7 * ^ 

// CC3={R5CFM=VBA,LRiCL = 13?,3 LKSI 2r = 35< G) 

//HI STSAV PGM=SI P£ SA VZ, R-lhiaM-= 130K ,1 1 5, CnN0 = 

T7ST(TFOl3nm'c5WT^l53T^ 0 rSP= S hp 


jNir 


Figure 6.2-15, JCL Procedure for IPS History Production Run 



>~~7 7T a'P E ! : '0PY~kx^r'Tnj M=T AP eco p' Y " VR£ 'g i on= 1 2 >" i r»r=y 

//SYSPRIMT 03 5Y3CUT=A» UNI T= (SYS0UT,2) ♦SPAC==( 3520» ( 5f 5) > 
.//SYSABENO 00 SYS0UT=A,SPA:E = tl6.32t » 300 ) ) t UN IT= ISYSOUT 1 2 ) 

I// fwDiir r»ft os NAH~ = I N30PYv DI SP=(OLO» KEE® )» UNIT={ TAP^t rOBFtR I t 


7/ INP.UT^OO, 




// : sLr;voL=SER=xxxxi 

//OUTPUT- OD OSNAPc=CJTC OPY, Dl SP=INEW»KEE» ) fUNIT%( TAPEPr yOBFER 
//• . LAB EL = USL, ;HXP GT=8536 5) \ __ 

"T/tUPYR E JS cXEC 'PGN=SIM'5^AWyRTGTa?J=lT0Xrr 
//STEPLIB DO DSN=SlNSIPS.LOADLIBtOISP = SW 

//SYSPRINT DD SYS0UT=A,UNIT={SYS0UT,2)f SPAC = =(3520,a0»5) I , 

• // DC8={RcCFM=VBAtLR“CL=137»BLKSIZE=3520) 

;■ //I N1 00;' {TS1NSSTT1STPS'.3^ir3TCANrOI SP= { OL DTKTEFy 


v,r: ' 







iKn 3 ^w^STV{Si F5".i^jvAJ^ s :^nmT{VTKir^T^i^^TSP^ { 

LABEL=(2 ,SL »eXPOT= 85365 ) tOCB= ( RS:CPM^ FB, LR ECU -41 ,B LK£IZ?=4103 » t 


p) 

= <»P6 0>'- 


Tn\m 

// 

// VOL*RHF=*,OiJTl 
//DELTREJS HXEC PGP=IEH PROGN , R:GI 3N =60K,r IME = ( ,5)»:0N0= 10, L Tr CD^ YR SJSJ 


TTTYEPRTNT'DOTTYSOUT = A 

//DELTl OD DSN=S1MSIPS.RE JSCAN,D!SP=( OLPtDELcTS)- ; 

//0cLT2 00 DSN=SIMSIPS.R£UVARS, DISP=nLD,OEUTH) 

//SYSIN DD DUMMY, DCB=(3LKS IZ£=60) . ' ■ v. - 

7YALL'DCR^J"'cXEr'T>GM=T^M'PRaGM",R£irrTJN=6^^^^^ 51 , 

// CONO=t (0,LT,C3PYRE J5J r( 0,LT,0cLTRE JS 1) 

, //SYSPRINT 00 SYSOUT=A 
; //ALLOCl CJ 3SN=SIMSIPS.REJSCAN,D!SP = IN?^ , CAT LG), UNrr^333Cj 

— 77 V3L=^S^=33300'A-,SP^T=fTP.Xr20J r 

r // 0CB=<RsCFM?PB,LRSCL = 246 ,31X5^^ = 4960) - > / 

I //ALLQC2 03 DSN=S IMSI PS . RE JV ARS, 01 SP= ( NSW ,CAT b3) ,'JNIT = 333 0, 

// • VaL=S2R=333004,SPACc = lTRK.30>, — ^ 

rT/—~0UB=lR2rFMi-FS; LTE^Cr^AITBIX STZF^l CrOT’ 

//SYSIN DO OJMMY,063={BLKSIZc=3C) 


- f 


1 

A 


• '•R V • 


Figure 6.2-16. JCL Procedure for Run to Group Raw Data and 
Save Rejected Data 


//?SIMSTa’p" J0B < ACC T INFO) ,MSGLFVeL=l , C LASS: 
7T 






//TAPECOPV. SYSIN DO * 

FIL.?S=1 iRE=L=XX-XXOL 
__D SN &M||ilMSIPJ 

□ SNAMEsSIMS IPS .PA WDATA. 0770101 
RUN=YFS,rILES=^l,REFL=XXXX02 

I^FO .FI L £ .0770 10 2 

^ I L c 1 

bSNAMF = SIMSIP S.RaWDATA. 0770102 
RJN = YC5 , files =1,R£cL=XXXX03 

OSN/^= S^ ,f I.U£..,Q770.LQ.3^_ 

FI U 5^P 


X 

X 


0SNAHE= si ms I»S .R AWDATA .07701 03 


A 

X 

'X 




RUN = YFS,FILFS = 1,RFEL= XXXX31 

0SNAME = SIMSIPS. si TEHF3.FILE.C77C131 

FILiS=l 

~D'S‘NA KTs sTTOTTs;i^i5wrAr ATrrrror 31 — r — " 


X 

X 




Figure 62-17. Sample Setup for Run to Group Raw Data 
and Save Rejected Data 
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Figure 6.2-14 contains a representative JCL procedure for the nightly IPS 
production run. A sample deck setup for the nightly IPS run follows: 

//PSIMSIPS Job (acct.), GLASS=C 

// EXEC SIMSIPNP, DA'EE=D760704, OLDDATE«D760703 

// 

DATE specifies the day (year, month, and day in month) on which the run is 
submitted. OLDDATE specifies the day of the previous run. The sample setup 
above would be correct for the run submitted July 4, 1976 for execution on the 
night of July 4 - July 5, 1976. 

NOTE: In support of S/7 to S/370 data transfer and nightly IPS execution the 

folloxjing data sets should be deleted each afternoon: 


SIMSIPS-RATOATA^ 

SIMSIPS . HOURLY . CURRENT 
SIMSIPS . DAILY - CURRENT 
SIMSIPS .ADDDETL 

SIMSIPS .RAWDAT A should be preallocated after being deleted. 

6. 2. 4. 2 History Production Run 

The history production run is e:-cecuted on a monthly basis after all data for 
all sites for the month has been processed and merged into the data base. (If 
all sites are called daily then the January run might be made the night of 
February 2 - February 3), The history production run includes executing the 
history program. 

Figure 6,2-15 contains a representative JCL procedure for the history production 
run. A sample deck setup for the run fallows: 

//PSIMSHST Job (acct,), CLASS=B 

7/ EXEC SitlSHSTpy PAE>I= ’ 7 70l31J.^1jmi5l97 7^{)5>5 ' 

// MONTH=JAN77, OLDDATA=D77020i 

The sample setup above would be correct for a history run for the month of 
January 1977 run the night of February 2 - February 3, FARM should contain the 
year, month, last day in the month of the history month plus a spelled out name 
of the history month. MONTH should contain a semi-spelled-out version of the 
history month ’JAN77’> ‘FEB77', etc, OLDDAIA should contain character D plus 
yesterdays year, month, and day in month. 
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NOTE; As preparation for the history production run, data set 

SBISIPS. DAILY. HISTORY should be renamed SIMSIPS .DAILY .OLDHIST. 

6. 2.4. 3 Run to Group Raw Data and Save Rejected Data 

This run groups many tapes of raw data and site data description files onto 
one tape. It also saves the contents of the rejected scan and rejected variable 
files on a permanent tape and reinitializes the rejected files. 

The job is run once a month. It is normally submitted on the first day of a 
month and run during the night between the 1st and 2nd days in the month. 

Figure 6.2-16 contains a representative JCL procedure (PROG) for this run. 
Figure 6.2-17 contains a sample deck setup for the run. 

The sanple setup is for the January 1977 irun which would be submitted the 
afternoon of February 1. S 3 mibolic parameter MONTH should specify the just completed 
month e.g. 'JAN77*^, ’FEB77', etc. The tapecopy Sysin cards should specify the 
copying of all the site information/raw data tapes for the month. Tape reel 
numbers and DSnames must be supplied. 

6.2.5 Site Descrintion File Maintenance 

Maintenance of the Site Data Description file includes; 

9 Making changes to the site data information card file in 

accordance with input received from site performance analysts. 

9 Running the Site Data Description utility to update the Site 
Data Description file. 

9 Examining printout from the Site Data Description Utility. 

9 Maintaining current listing of file contents. 

Changing the Site Data Information Card File 

The Site Data Information Card file is a PDS (DSNAME is SIMSIPS, SITEINFO. 

CARDS) with one member for each active site. The member for site XXXXX is named 
SITxxxxx, The member for a site contains one general information card (A-card) 
for the site and one card (B-card) for each measurement (i.e., parameter recorded) 
at the site. Add, replace, or delete subcodes 'A’, 'R*, or 'D' must be placed 
ill column 7 of the A-cardsi The order must be A-Card, then B-cards, Formats of 
cards are shown in figure 6.2-18. Instructions on completion of cards are con- 
tained in Section 8.2 of this document. 

Either MTflT or lEBUPDTE may be used for UPDATE; however, a record of all 
changes must be maintained. 



PAGE 1 = GENERAL INFORMATION 

DATE;__ : 

NEW, CHANGE, OR DELETE (CIRCLE) 
SIGNATURE:.^ — . .. 

SITE DATA INFORMATION 

TO CHANGE ANY INFORMATION ON THIS PAGE, COMPLETE ALL ITEMS 
EXgEPT CARD CODE, TO DELETE A SITE, FILL IN SITE ID AND DATE, 

CIRCLE 'DELETE' AND COMPLETE SIGNATURE. 

— — SITE ID (EXAMPLE 00043) 

5 

A CARD CODES (RESERVED FOR FILE MAINTENANCE TECHNICIAN USE) 

— — SYSTEM TYPE ('HC' = HEATING & COOLING, ‘m = HEATING, OR 'HW' = HOT WATER) 

B 9 

PRINT LEVEL ('12' = MOST DETAILED LEVELINCLUDES PRINT OF DETAIL RECORDS, 

to 11 'OS'= NORMAL LEVEL, '04' = LESS DETAIL THAN NORMAL, 

'00' = NO PRINTING) 



%o 



12 13 
■ l4 

15 ““ ^ TIT 


SCAN LEVEL (NO. OF BYTES OF DATA IN ONE SCAN. DO NOT INCLUDE TIME BYTES). 
TIME ZONE ('E‘= EASTERN, 'C'- CENTRAL, 'M' = MOUNTAIN', 'P' = PACIFIC) 
COLLECTOR AREA (SQUARE FEET, RIGHT JUSTIFY) 


Figure 6.2-18. Site Data Information Forms (Page 1 of 3} 


CARD CODE a 


MEASUREMENT 

DESCRIPTIVE 

NAME 


SITE DATA INFORMAr 

IF NEW COMPLETE ALL INFO ABOUT ALL . .ASUREMENTS AND 
LINE THROUGH NON EXISTENT MEASUREMENTS 

IF CHANGE COMPLETE ALL INFO ABOUT A NEW OR CHANGED MEASUREMENT 
LINE THROUGH TO DELETE A MEASUREMENT, 


BYTE 
POS IN 

MEAS SCAN 
CODED I » 1st 
NAME BYTE 


LENGTH 

IN 

SCAN 
1 OR 2 


CONVERSION INFORMATION 

TYPE MAY BE L = LINEAR, 

Q - QUADRATIC, T » THIRD ORDER | 
OR D = DISCRETE, IF I IS RAW BIT | 
VALUE SEE FORMULAS BELOW TO ^ 
COMPLETE CONVERTED VALUE CV ^ 


UNIT 

OF 

CONVERTED 

VALUE 


PG 2 PART 1 OF MEASUREMENT I 

DATE: 

NEW OR CHANGE (CIRCLE) 

RESP SIG 

TESTING INFORMATION 
UNITS OF 

COMPUTED VALUE 'TO 
I (maximum 

MIN MAX change FROZEN 
VALUE VALUE BETWEEN STATE 
READINGS 


WIND DIRECTION 

D0U1 

COLLECTOR CIRC PUMP POWER 

EPtOl 

HW ELEC AUX POWER 

EP300 

HW CIRC PUMP POWER 

EP301 

HTG ELEC AUX POWER 

-EP400 

HTG LOOP CIRC PUMP POWER 

EP4Q1 

BLDG FAN POWER 

EM02 

HEAT PUMP COMPRESS POWER 

EP-flbs 

ABSORP CHILLER OPEN POWER 

EP501 

HWAUX FUEL FLOW 

F300 

I’lTG AUX FUEL FLOW 

F400 

COOLING AUX FUEL FLOW 

rsoa 

TOTAL RADIATION 

1001 

DirruSE nADlATION 

IU02 

OUT DOOR DB TEMPERATURE 

TOOT 

COLL ECTOR INLET TEMPERATURE 

TlOO 

storage inlet temperature 

T101 

COLLEtn on ABSORBER TEMP 

TT02 

STORAGE MEDIA AVG TEMP 

T2o6 

STORAGE AMBIENT TEMP 

1'201 

MAKEUP WATER TEMP 

T300 

HX INLET TEMP 

T301 

load return TEMP 

T400 

LOAD If'X INLET TEMP 

T5P0 

"cooling TOWER (NLETTEMP 

T501 

DlDG RETURN AIR DB TEMP 

TOGO 

BLOG RETURN A|R WB TEMP 

TGQ1 

BLDG SUPPLY AIRWBTEMP 

T602 


0 FROM N 
KW 
KW 
KW 

"kw 

KW 

“kw 

KW 

Tkw ^ 

: FT3/MIN 
FT3/MIN 
FT3/MIN 
KGTU/lin 
~KGTU/HR 
«F 


KEYPUNCH SITE ID i 
CARO CODE OR ALL CARDS 


TYPE 

Lt CV • A + Bl 

Q! CV » A 4^ BM C|2 

T: CV » A •» Bl + C|2 ♦ Dp 


TYPE 
D: CV 


1, IF A<_l;CB 
O OTHERWISE 


Figure 6.2-18. 'Site Data information Forms (Page 2 of 3} 
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CARD CODE B 


MEASUREMENT 

OESCaiPTiVE 

NAME 


COL i.HcrpfT temp DI FE 


STOIIAGE TEMP DIFF lcaiS) 


SrORAGE TEMP DIFF (llWii) 


HXTEMPDIFP 


LOAD MX TEMP DIFF 


SrORAGE- TEMP DIFF HiTSl 


AUkll (ARY TEMP. DIFF 


LOAD HJ< TEMP DIFF (Ills) 


l.OAO MX TEMP OIFF (SCSI 


COOLING TOWER TEMP DIFF 


.SUPPLV/RE'fURN AIR TEMP DIFF. 


VV!ND VELOCITY 


COl.LECIOH FLOW RATE 


:;CUK;in:Al |t.iffFLOW RATE (IIWS) 


IOAD FLOW RATE : 


Cl UC;UL ATt ON FLOW RATE tl ITS] . 


LOAD MX FLOW RA FE ; 


COOLING TOWLR FLOW RATE; 


lU OG AI R FLOVV RATE: : 


TiNOENKAlE FLOW 


Gif ARE 


SPARE 


SPARE 


i 


PARE 


PARE 


PARE 


SPARE 


SPARE 


SPARE 


KEYPUNCI | S|TE ID + 

CARD CODE OR ALL CAMDS 




$fTE DATA IWrOHMA' 


PO 3 PART 2 dr MEASUREMENT » »ST 


IF NEW COMPIEIE AIL INFO ABOUT Ai . ASUnfL|y»EN TS AND 
UNE through NON EXISTENT MEASURfcMENIS 

IF CHANGE COMPLETE AIL INFO ABOUT A NEW OR CHANGED MEASUREMENT 
LINE THROUGH TO DELETE A MEASUREF/feNT. 


NEW OR CHANGE (GmCLE) 
MESF SIG 


BVTE 
POS IN 
SCAN 


CONVERSION INFORMATION 


I ESTING JNrORMATlON 


coneo 1 ut 

NAME BYTE 


LENGTH 

TN 

SCAN 
1 OR 2 


TYPE MAY BE L « LINEAR, 

Q QUADRATIC, T - THIRD ORDER 
OR D - discrete, if I IS RAW BIT 
VALUE SEE FORMULAS DCLOW TO 
complete CONVERTED VALUE CV 


UNITS 

OF 

converted 

VALUE 


UNIT 5 OF 

COMPUTED VALUE 


MAXIMUM 
MIN [MAX CHANGE 
VALUE VALUE BETWEEN 
READINGS 


TDloa 


rmoi 


TD 31 X 3 


TD400 


TD 50 D 


•TO 

TEST FOB 

FROZEN 

STATE 


GAL/MlN 


GAL/MIN 


GAL/MIN 


GA17MIN 


CTAL/MIN 


FT3/MIN 


FTByNlIN 


L: CV-* A * DI 

Q: CV = A i Bl f ei2 
T: CV »= A FBI I CI2l Dl^ 


1, JF A_<I< B 
0 OTHERWISE 



























































































Running the Site Data Description Utility 

Figure 6 . 2-19 contains the JCL procedure for executing the Site Data Description 
utility* Figure 6.2-20 contains a sample deck setup for executing the procedure. 

The date parameter is used to specify the year, month, and day of the run. . 'OPTION^ 
OLD' means this is a nomal run updating the Site Data Description File. '0FTI0N=NEW’ 
would he used for a run creating a new Site Data Description File. "OPTION-PRINT' 
specifies a run to print the contents of the file. ’OPTI0N='0LD' is a default para- 
meter* SYSIN should include, concatenated together, the members of the site data 
information card file for all sites whose information is to he added, changed, or 
deleted. 

Examining Printout from the Site Data Description Utility 

Site Data Description Utility printout includes: 

t> An overall summary page (see figure 6.2-21) 

• A print of card images and errors detected in the cards for each 
site for which information was added or changed, (see figure 
6 . 2 - 22 ) 

o Printouts of new or replacement site data description records 
which vjere placed in the site data description file (see 
figure 6.2-23) 

NOTE; The Site Data Description Utility can be run in a print 
only mode in which all records in the Site Data 
Description file are printed. 

B Possible messages about sites being deleted or cards out of place. 

Error condition/m^sages and corrective actions are shown in table 6.2-4. 
Maintain Current Listing of File Content 

A Site Description File Maintenance Notebook must be maintained which contains 
the current contents of each entry in the file. A history of all changes must be 
included in the notebook. Upon completion of each update cycle, the resulting 
listing must be added to the notebook. 

Copies of current contents listing must be provided to Performance Analysts. 
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t ’-7/- PgaE'‘'ffm’gW»Qi: OVEAYS^g036 Q'^DyTgg p4TS';" "' V- - y ■' •'-• 
'“/rsAvg"EX^‘W[;w5ifc;s ao65U» Redo'^^Tai^ ,t . 

//SYSPRINT DO SYS0UT«4 

//SYSUTU 30 DSN=^SIMSieS.SITl:IYFO.CA3DS,3 1SP»SHR ^ 

WSYSUTZA* DO PSNsSI NS I PS. SI TgnFO* CAP OS .SP ATE tO IS P^I Mrn» <SSP) t 

'Hi/laoy^sxcC ^ ImS I lit oo5^ 5’ IS i on= 1 Iok » Ti m|'=j5 » p gp 

1 //RPTPRNT D3 SYS3UT= &» u3B=( RP3FM»VPA* tP ;Ct=137» BL<£ IZ|-3520) 

! //TOTRPT OD SYS3UT*Af D:S={ R2Cr*^»VSAtLRrCL=137i?LK£I Zr = 3520) 
IT/H YSPRI'Yt"0ir5VSOUT=A iDC B afR^CFI^TOAt t FFCi:=13TT^KSTZr»?52 or:: 

Figure 6.2- 19. JCL Procedure for Site Data Description Utility 


ff 

J3B _i_AC. 

CT 

IN 

Fci 

UlS£ 

=^9 






" T/ 

C’Ar;U 

W5 

i:'V 

U t ^ ^ 

r. 

60''* 

3 Jf 


':'! 3\= 3L' 



//s 

ODvKSYS 1 

H 

DO 

DS.N=S 

i'^si 

P S-. 

SIT 

FI 

•JFD.CAPD 

5( 

S IT 000 03} 

if 


DO 

DSN=S 

I NS I 

PS. 

Si T 

t 

i 

C i.'’F 

SI 

S IT003C? ) 

ft 



03 

DSM=S 

I^SI 

£S . 

aU 

FI 

N=a.cap-:. 

SI 

SI T00013) 


TF^ — ~~ " ^ 

Figure 6.2-20, Sample Setup for Site Data Description Utility 
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SD49 DATA lllFGMATtCH PlLC UTILITY PROMAW PAGE I 

totals report for all scass oate I i2/ia/rf 

.tine I 0090 

ODAS 10 HON PUSPCSE iERRCAS STATLS 

L- OAT REPLACING A SQAS 0 AA SiCCESSPUL *♦ 


I TOTAL SOA5S PPCC6SSE0 

1 TCTAt CCCC 5CA$$ 

O TOTAL BAD SQA5S 

FPCCEEStNC CCPPLETE « « 1 # 


I L • iC I * 5*£ih t* 1 L 


i lu, 


I 


§1 


^ & 


SD^E DATA tNPORKATiaN PU.E U*' IHTY PRQGPAM 
UTILItV RUN FOR PURPOSE OF REPLACING A SOAS 
SO AS ID G32 


4«A*« CARD 
0329CH4e 

IMAGES and 
452CO.O 

ePRCP ME 

S SAGE 5 
1*0 

c*o 

Qmd 

0.0 

1023# 

IC23. 

SPQ3 1 

032OCH0A 

072L0 



Q* 

0. 

0 

SO 

♦ Sip .000 

Aini qo 

032SCH06 

I12L0 


fO^vf ‘le^E-c? 

c. 

0* 

0 

100 

4100 mOO 

•TO! 01 

032aCH34 

GTate 


>0R7F563E“0r 

p* 

0 4 

0 

100 

4 Ido *00 

4TD3C0 

OSaDG-FlO 

IR2L-20 


3(^:7 LP7E-C1 

c. 

0, 

-20 

120 

♦lAO.OO 

ATOOl 

C3 2 BCH C2 

a32U30 


4-1 453.1 P5F-0 T 

. 0. 

0* 

70 

230 

42CC.00 

*1100 

GiaacHis 

ai2L:ic 


4“ i?3E3l 25E-07 

0* 

0* 

30 

230 

4200.00 

•TlOl 

0323CN20 .. 

1^>£13Q 


+ A t C 1 *5 € 2F - C 7 

C m 

c. 

3C 

AST) 

4420. CO 

*1102 

0323CHM 

27SU3C 


4 1 5531256-07 

0. 


30 

230 

4 200*00 

*T20C 

0323Chife 

312L2C 


+ ?9£ 2 C 7 

c. 

D, 

30 

230 

4200.00 

*T201 

02 2E CHIP. ' 

3 5 2L 3 C 


*■1 iF3i 25F-Q7 

0 . 

■ ' 

no 

-230 

4200*00 

*1202 

032eCH0a 

J62U30 


H£e5 5;in".G7 

c* 

0* 

30 

160 

4130*00 

*T3O0 

032f^*>Kl5 


D0X-C7 

+ 1 cooaoae-0* 

0 . 

0# 

0 

10 

41 C* 000 

* *1 00 

0323CHO^ 

0^2R0. 


f 5 -ifl 3E-07 

0 - 

0* 

0 

10*1 

410.100 

**30 1 

TCTAL r-i-CARDS PrcCEEEEO = Afl 








END QF SCAS 

tSFnftUATlCN file update FCR Sf'AE 
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PAGE 3 


date : 0q:/29/77 
TINE : 1344 


cn 


SDAS data INFaRHATIOH FILE UTILITY PHOGRAH ^ 
UTILITY RUN FOR PURPOSE OF ADDING A SDAS ♦♦ 
SDAS ID 063 •" 


■y 


PAGE 1 

DATE s X2/16/7T 
TIME 3 1354 


SDAS^lO 

063 

GENERAL INFORMATION REPORT 

PRINT-LEVEL 

12 


SCAN_LENGTH 

192 


TI HE_ZONE 

. 

>Tj Q 

II 

TIME_20NE_OFfSET 

0 

"SITE_ID 

025 

SUB-TYPE 

5 


REV^LEVEL 


V— i sj> 

s 

REV-TIME 

77/12/16 13.5A 


SITE-NAME 

RANDOLPH APB 


ANALYST-NAME 

WKNQWN 


ENGINEER-NAHE 

UNKNOVN 





CODED MEASUREHEriTS REPORT 


MEASUREMENT 

SCAN 

PQS 

L£N 

NIPS 

PQS 

CONV 

TYPE 

CONV III 

CONV #2 

CONV #3 

CONV #4 

KINlhUH 

VALUE 

NAXIHUH 

VALUE 

KAXrHUM 

CHANGE 

MUST 

CHNG? 

CHOI 

CAtlB 

1 

2 

1 

L 

0.000000 

I. 000000 

0.0000000 

O.OOOOOEt-00 

0.00000 

1024.00000 

1023.000000 

YES 

CH64 

DOOl 

127 

2 

64 

L 

Q.OOQOOO 

0.351906 

0.0000000 

O.OOOOOE«-OQ 

0.00000. 

46B. 00000 

463.000000 

YES 

CH65 

EPIOX 

129 

2 

66 

L 

Q.oooboo 

0.039101 

0.0000000 

O.OOOOOEf-OG 

0.00000 

52.00000 

52.000000 

YES 

CHTl 

EP3U 

i4l 

Z 

71 

L 

0.000000 

0.003910 

Q. 0000000 

O.OOOOQE+00 

0.00000 

5.20000 

s.aaoDoo 

YES 

CH66 

EP312 

131 

2 

66 

L 

p.oooqoo 

0.003910 

o.ooooooo 

0.O0000E4-0O 

O.OOQOO 

5.20000 

5.200000 

YES 

CH72 

EP313 

143 

2 

72 

L 

b.oooooo 

0.003910 

0.0000000 

O.OOOpOE+00 

O.QQOOO 

5.20000 

5-,2DOOOO 

YES 

CH6T 

EP401 

133 

2 

67 

L 

D. 000000 

0. 039101 

o.ooooooo 

0. OOOODE'I'OO 

0.00000 

52.00000 

52^000000 

YES 

CK81 

EP404 

i&l 

2 

81 

L 

0.000000 

0.156^03 

o.ooooooo 

O.OOOOOE-l-00 

0.00000 

200.00000 

208.000000 

YES 

CHB2 

EP405 

163 

2 

82 

L 

O.OOOQOO 

0.1564 03 

o.ooooooo 

O.OOOOOE-i-00 

o.ooooq 

208^00000 

200.000000 

YES 

CH73 

&P412 

145 

2 

73 

L 

O.OOQOQO 

0.039101 

0.0000000 

a.oooooE4-oo 

Q. 00000 

52.00PO0 

52.000000 

YES 

CH8G 

EP413 

159 

2 

00 

L 

0.000000 

0.0009 76 

O.OQOQOQO 

o.aooooE4-oo 

0.00000 

0.65000 

0.650000 

YES 

CHS9 

EP414 

177 

2 

09 

L 

0^000000 

0.002930 

0.0000000 

0. oodboE-i-00 

o.odooo 

l.g49'90 

1.949900 

YES 

CH91 

2P415 

181 

2 

91 

t 

0.000000 

0.011730 

o.ooooooo 

O.OOOOGEf^OO 

O.OOOOQ 

15.60000 

15.599999 

YES 

CH92 

eP4l6 

183 

2 

92 

L 

0.000000 

0.011730 

0.0000000 

0,O0bOQEt-0O 

O.QQOOO 

, 15.60000 

15*599 999 

YES 

CK84 

EP501 

167 

2 

84 

t 

Q. 000000 

0.0070 20 

0.0000000 

O.OOQOOEf-00 

D.pooop 

10.40000 

10.400000 

YES 

CH90 

EP503 

179 

2 

90 

L 

0.000000 

0.039101 

0.0000000 

0. oooooE+oa 

O.OOOOQ 

52.00000 

52.000000 

YES 

CH83 

EP504 

165 

2 

83 

L 

o.ooqqoo 

0.OU73O 

0.0000000 

0.00000E4-00 

0.00000 

15.60000 

15.599999 

YES 

CH2T 

F300 

S3 

2 

27 

L 

O.OOOQOO 

0.782014 

0.0000000 

O.OOaOOE«-QO 

o.ooqop 

1040.00000 

1040.000000 

YES 

CH49 

tool 

97 

2 

49 

X 

0.000000 

2. 86 7822 

0.0000000 

O.OOQOOEt-OO 

0. 00000 

458.10986 

458*109063 

YES 

CH09 

Spool 

IT 

2 

9 

t 

0.000000 

uoooooo 

o.ooooooo 

0.0aD0pE«^00 

0.00000 

1024.00000 

1023.000000 YES 

CH42 

SP002 

S3 

' 2 

42 

L 

0.000000 

l.ODQOOO 

O.OOOOQpO 

0. OOOOOE-i-00 

O.QQOOO 

I024.00d00 

1023.000000 

YES 

CH46 

SP003 

91 

2 

46 

L 

0.000000 

1.000000 

0.0000000 

0*OOO0GE4-0O 

0.00000 

1024.00000 

1023.000000 

YES 

CHAT 

SP004 

93 

2 

47 

L 

Q.ODOOOO 

1.000000 

0.0000000 

O.OOOOOEf-00 

0.00000 

1024.00000 

1023.000000 

YES 

CH53 

SP005 

105 

2 

53 

L 

0.000000 

1.000000 

o.ooooooo 

O.OOOOOEi-00 

0.00000 

1024.00000 

1023.000000 YES 


Figure 6.2-23. Sample Site Data Description Record Contents Report 


Table 6^4, Site Data Description Utility Mes^ges (Sheet I of 6 1 


Message: ’CONVERSION ERROR IN EIELD’ ' HMNNN * ’REPLACED BY 0’ . **ERROR** 

Reason: An invalid numeric character has been detected in field ’ HNNHN ’ 

and replaced :irLth zero so that further editing may continue. 

Action: The Invalid numeric field must be replaced with a valid numeric 

field and the program rerun. If a number other than zero is 
desired. 


Routine * 


Main PGM 


Message: ’RECORD NOT FOUND FOR SITE ID NUMBER NNNNN **ERROR** 

Reason: An attempt was made to delete or replace a site ID not on the 

Site Data Description file. ' NNNNN ' is the ID Number. 

Action: Change the Site ID to a valid number that exists on the file and 

rerun the program. 

Routine: Main Program 

Message: 'RECORD ALREADY EXISTS FOR SITE ID NUMBER’ ** ERROR** 

Reason; An attempt was made to add a duplicate site to the Sice Data 

Description file. ’ NNNNN ’ is the Site ID. 

Action: Change the Site ID Number to one that is not on the file and rerun 

the program. 

Routine; Main Program 

Message: ' INVALID KEY FOR SITE ID NmffiER' NNNNN **ERR0R** 

Reason: A conversion error was detected when the Site ID was used as key 

in reading or writing the file, ’ tiNNNN * is the invalid number. 

Action; Correct the Site ID Number and rerun the program 


Routine: Main Program 


Message: ’PRINT OPTION tOMPLETE' 

Reason: The last record on the file has been printed using the 'print' 

option. .. 

Action: None 


Routine: Main (print cptibn processing section) 
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Table 6.2-4. Site Data Description Utility Messages (Sheet 2 of 6} 


Message; 'SITE ID' NHWMN 'DELETED FROM THE SITE DATA DESCRIPTION FILE' 


Reason; 


Site ID Number 'NNNNN' has been deleted. 


Action ; 


None 


Routine; Main Program ('Delete' processing section) 


Message: 'A-CARD—COLUMN 7— IS NOT EQUAL TO A, R, OR D' **ERROR** 

Reason; A valid code has not been entered into Column 7 of the A~Card. 
Valid codes are;- A » ADD, R = REPLACE, or D = DELETE. 


Action: 


Correct and rerun 


Routine: Main Program 


Message: 'ERROR IN PROCESSING A-CARD-TYPE FIELD = 


**ERROR** 


Reason; 


Column 6 of the A-Card does not contain an 'A'. 


Action: 


Correct and rerun. 


Routine: Main Program (A~Card section) 


Message: 'TOTAL B-CARDS PROCESSED 'NN' 

Reason; To print total number of B-Cards processed for one site, 'M' is 
the total. 


Action; 


None 


Routine: Main Program (B-Card processing section) 


Message: 'END OF SITE INFORMATION FIELD UPDATE FOR SITE' NNNNN 

Reason: Successful end of utility for site 'NNNNN ' 

Action: None 


Routine: Main Program 




Tabls 6,2-4. Sits Data Oeterif/tion Utility Messages (Sheet 3 of 6) 


Message: 

'SITE DATA DESCRIPTION FILE NOT 

UPDATED FOR SITE' NNNNN. 

Reason: 

Unsuccessful end of a site. For 

site 'NNNNN'. 

Action: 

Correct errors and rerun* 


Routine : 

Main Program 


Message: 

'SITE ID INVALID' **ERROR** 


Reason: 

Site ID value entered is less than 1 or greater than 99998. 

Action: 

Correct and rerun. 


Routine : 

A-Card-Edit . 


Message: 

'VV' IS NOT VALID FOR SYSTH'l TYPE **ERROR** 

Reason: 

Value 'W' entered is not equal 
is the value entered. 

to 'HC, 'H', or 'HW'. 

Action: 

Correct and rerun. 


Routine: 

A-Card-Edit 


Message: 

W 'IS INVALID FOR SCAN-LENGTk' 

**ERROR** 

Reason: 

Value 'W* entered is less than 

'8' or greater than '92', 

Action: 

Correct and rerun. 


Routine : 

A-Card-Edit 


Message: 

VV 'IS INVALID FOR PRINT LEVEL' 

**ERROR** 

Reason: 

Value 'W entered is not equal 

to 0, 4, 8j or 12. 

Action: 

Correct and rerun 


Routine: 

A-Card-Edit 
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Table 6.2-4. Site Data Description Utiiity Messages (Sheet 4 of 6) 



Message; 

Reason: 

Action: 

Routine : 

Message: AAAAAA 'HOT FOUND IN VARIABLE NAME TABLE’ **ERROR** 

Reason: The variable entered was not found in the variable name table. 

Action: Correct and rerun. 

Routine : B-Card-Edit 

Message; 'IS INVALID VALUE FOR INPUT LENGTH’ **ERROR** 

Reason: Input length 'LL* entered is not equal to 1 or 2. 

Action: Correct and rerun. 

Routine: B-Card-Edit. 


AAAAAA 'HAS ALREADY BEEN USED AS A VARIABLE NAME IN A PREVIOUS 
B~CAED' **ERROR** 

The variable name 'AAAAAA' has already been used in a previous 
B-Card. 

Correct and rerun. 

B-Card-Edit 


original ?a.g:^ 

OF POOR 
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Table 6Ji-4. Site Data Description Utility Messages (Sheet 5 of 6) 



— ! 

* **'"■’ i ’ T * ^ S " T'l V - ^ y • . ~ 

Reason; 

’NN' entered for position in input is less than zero or greater 
than the scan length. 

Action: 

Correct and rerun. 

Routine: 

B-Catd-Edit 

Message: 

’INVALID FOR CONVERSION TYPE' A*ERR0R** 

Reason: 

*V* entered for conversion type is not equal to 'L’, 'Q’, ’D', 
’T’ or ’R’. 

Action; 

Correct and rerun. 

Routine: 

B-Card~Edit 

Message: 

"CONVERSION FARMS INVALID FOR CONVERSION TYPE. ONLY FIRST TWO 
FARMS USED. **ERROR** 

Reason: 

Conversion Type is ’L', 'D’ or 'R* and conversion 3 or 
conversion 4 is not equal to zero. 

Action: 

Correct .and rerun. 

Routine: 

B-Card-Edit 

Message: 

'CONVERSION FARMS INVALID FOR CONVERSION TYFE. SECOND FARM 
CANNOT BE LESS THAN FIRST FARM. TERROR** 

Reason; 

Conversion type is 'D* and first and second parms must specify 
a range. 

Action: 

Correct and rerun. 

Routine : 

B-Card-Edit 
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Table 6.2-4. Site Data Description Utility Mes^ges (Sheet 6 of 6J 


Message: 

Reason: 
Action: 
Routine : 

'CONVERSION FARMS INVALID FOR CONVERSION TYPE. ONLY FIRST 
THREE FARMS USED. **ERROR** 

Conversion type is equal to 'Q' and C0NV4 is not equal to zero. 
Correct and rerun. 

B-Card-Edit 

Message; 

KNNNNNNN ' IS INVALID FOR MAXIMUM VALUE BECAUSE 
THE tUNIMUM' A*ERROR** 

IT IS LESS THAN 

Reason: 

Value 'NNNNNNNN' is invalid for reason stated. 


Action: 

Correct and rerun. 


Routine; 

B-Card-Edit 


Message: 

NNNNNNNN 'IS INVALID VALUD FOR MAXIMUM CHANGE' 

AAERRORA* 

Reason: 

Maximum change (NNNNNNNN) is greater than maximum value minus 
minimum value. 

Action: 

Correct and rerun. 


Routine: 

B-Card-Edit 
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6 . 3 DAIA BASE MANAGEMENT PROGRAMMER/ AliALY ST USER GUIDELINES 


The Data Base Management Programmer/Analyst must support the following capa- 
bilities within the GDPS: 

• Maintenance of Data Base Software 

• File Maintenance 

e Terminal Processing 

• Information retrieval 

• Output Processing 

« Plots of instrumentation data 


The user guidelines to follow in providing these services are contained in 
subsequent paragraphs. 


6.3,1 Applicable Documents 

The follOT^ing documents are required in order to support the use of the 
DATA BASE: 


Document Name 

NIPS Users Manual Error Codes 

NIPS Users Manual Job Preparation Manual 

NIPS Users Manual Retrieval and Send 
Processor 

NIPS Users Manual File Structuring 

NIPS Users Manual Introduction to 
File Concepts 

NIPS Users Manual Output Processor 
NIPS Users Manual Utility Support 
NIPS Users Manual Terminal Processing 
Installation of NIPS 360 FFS 
NIPS Processing Handbook 
NIPS General Description 


Number 


CSM-UM-15-74 


CSM-UM-15-74 


CSM-UM-15-74 

CSM-UM-15-74 


CSM'^UM'rl5'^7 4 
* CSM-UM-15-74 


CSM-UM-15-74 


CSM-UM-15-74 

CSM-UM-15-74 

TR-80-72 

CSM-UM-15-74 
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6.3.2 Maintenance of Data Base Software 


i 


ii 



■i 

; 


The Data Base Softx/are consists of the National Mllltaxy Command and Control 
Information Processing System (NIPS) . This system is operational within the Host 
Computer and is maintained through changes generated by IBM PSD Gaithersburg 
personnel. Any changes made are distributed to the Data Base Programraer/Analyst 
for evaluation of applicability to SIMS utilization of the system. If considered 
essential to SIMS use, modification will be made to the data base software. 

The Source Statements for NIPS are maintained in Washington, D.C. and are in 
S/360 Assembling Language form. Only the load modules are distributed for 
installation at outside facilities. Installation procedures are crntained in 
"Installation of NIPS 360 FFS“ manual. 

The Data Base Software Load Modules are stored on disk X'rithin the S/370-145 
and are named "FFSLIB.'* A backup image of the system is maintained on magnetic 
tape. 

If changes are required to NIPS to support SIMS, formal requests will be made 
to IBM personnel in Gaithersburg to implement our unique requirements. 


6.3.3 NIPS File Maintenance 


File maintenance accepts the data bank update Information generated during the 
input processing phase as well as inputs from system analysts, integration personnel 
and test personnel. It provides the capabilities required to enter/ delete/ archive 
data within the data bank. 

The capabilities of file definition, file maintenance, and file revision provide 
the user with a broad and flexible capability for generating and maintaining data 
files. The user may add, delete, or change file records. Also, he may modify or 
change file fields and may change (increase or decrease) the volume of data associ- 
ated with any file record. In addition to maintenance (or generation) of a- data 
file, the user may create auxiliary output files simultaneously with the maintenance 
process. 

A generative code technique is used in the actual data manipulation. To avoid 
wasteful regeneration, the system provides a complete, automatic library maintenance 
function for user logic statements. Maintenance execution, therefore, may consist 
of executing prestored logic statements, compiling logic statements and library 
updating, or a combination of these functions. 

Other component functions provide for the creation of summaries, run logs, 
and/or audit trails during file processing. 


Job Control Language (JCL) Statements to be used in file maintenance are found 
in "NIPS Users Manual - Job Preparation Manual." 


ORIGINAL PAGE IS 
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File Strueturing/Deflnitlon - The user submits, as input to the file 
structure component, a deck of statements defining the format for his 
file using the standard File Structuring Language detailed in the KIFS 
user manual Vol. II. An example of a Remote Site Operational data file 
structuring is shovm in figure 6.3-1 with comments Indicating the input 
card fields and their use. The NIPS file layout listing resulting from 
a computer generation of the File Structure module of HIPS is shown in 
figure 6.3-2. 

File Revision r This routine of NIPS provides for the restructuring of 
an existing data file allowing for the deletion, addition and relocation’ 
of fields within the data file as well as changes to their storage mode, 
size and name. A user structures a File Format Table (FFT) describing 
the file in its revised format. The NIPS procedure 'XF’ is then executed 
to provide the automatic generation of data sets and File Structuring 
control language to accept the desired data from the old file format and 
generate a new file with the desired changes incorporated. Figure 6.3-3 
is a listing of the resulting output of a File Revision run of the NIPS 
system where File SOLSTAT was being revised and called File SOLSTAA. 

File Maintenance - The File Maintenance routine provides the tool for 
generating and maintaining the structured data files. It will accept 
fixed or variable length, blocked or unblocked, or undefined trans- 
action records from tape, disk, or card files. On any given File Main- 
tenance run, file updating can be performed with a variety of trans- 
action record formats. The user supplies the record update logic to be 

used in File Maintenance by writing logic statements in the File Main- 

tenance Language. The File Maintenance Language commands are des- 
cribed in detail in the Users Manual on File Maintenance (Vol. III). 

A sample of File Maintenance Logic Statements is shown in figure 6.3-4. 
This series of commands was used to update a file named SOLSIT from a 
transaction tape containing parameteric data tvhich would be obtained 
from the sensors at a remote location. 

6,3.4 Terminal Processing 

Terminal processing provides the user with the capability to access data within 
the data bank via an on-line terminal. It provides the interface to support both 
local and remote terminal devices and provides the user an on-line data retrieval 

capability and a display language for outputting data. In addition, it performs 

the translation of data base interrogation statements, performs sorting of data 
to be outputted, if requested, and qualifies the records for output dependent upon 
them meeting the criteria set by selected relational operations (such as equal to, 
greater than, less than, etc.) in the inquiry being processed. 

The output portion makes available to the user operators for (1) placing infor- 
mation at the top and bottom of every page of output, (2) repositioning the display 
page number and/or system date, and (3) controlling the number of lines shown on 
each display page. v 
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Vi; • 

STRUCTURE SOLDATA. 


IPIELO 

FIELD 

FIELD 

FIELD 

9 

GROUP 


® ® (D (z) 

ftUSiD 2 C ALPHA 

RSYID 2 C ALPHA 

RDATE 5 C ALPHA 

RTMINT 1 C ALPHA 

SYSGRP &OSIO RSYID ROATE 
© 


•SYSTEM SITE ID* 
•SYSTEM TYPE*. 
•DATE OF RECORD*. 
•CODE*. 


RTMI NT • 


field 

RTCD 

2 

Cl 

©X 

NUMER 

•CODE*. 

FIELD 

XCOLID 

2 

ALPHA 

■COLLECTOR ID* . 

FIELD 

XCMBR 

2 

X 

ALPHA 

•MANUFACTURER CODE*. 

FIELD 

XCMAT 

2 

X 

ALPHA 

•MATERIAL CODE*. 

FIELD 

XCTYPE 

2 

X 

ALPHA 

•COLLECTOR TYPE*. 

FIELD 

XCOST 

2 

X 

ALPHA 

•COST CATEGORY*. 

FIELD 

X&FF 

2 

X 

ALPHA 

•EFFICIENCY RATING*. 

FIELD 

kSTOID 


X 

ALPHA ’ 

•STORAGE ID*. 

FIELD 

COMID 

2 

X 

ALPHA 

•COMMERCIAL ID*. 

FIELD 

XCQID 

2 

X 

ALPHA 

•CODLING SYSTEM ID*. 

F I ELD 

XCOMAID 

2 

X 

ALPHA 

■COOLING MATERIAL I D* , 

FIELD 

xheatid 

2 

X 

alpha 

•HEATING ID*. 

FIELD 

XHMAT 

2 

X 

ALPHA 

•HEATING MATERIAL*. 

FIELD 

XCONT 

2 

X 

ALPHA 

•CONTROL SYSTEM*. 

FIELD 

XHOTIO 

2 

X 

alpha 

•HOT WATER ID*. 

FIELD 

XHQTTYP 

2 

X 

ALPHA 

•HOT WATER TYPE*. 

FIELD 

XtRAN 

2 

X 

ALPHA 

•TRANSPORT TYPE*. 

FIELD 

RTARM 

4 


NUMER 

•HOUR/MINUTE OF READING*. 

FIELD 

RP IL 

4 

NUMER 

•STORAGE TANK ULLAGE-ABSOLUTE PR 

FIELD 

RPl A 

4 

1 

NUMEK 

•STORAGE TANK ULL AGE-ALTERNATE* . 

FIELD 

RP2L 

4 

1 

NUMER 

■COLLECTOR PUMP OUTLET*. 

FIELD 

RP2A 

4 

1 

NUMER 

• collector FAN OUTLET*. 

FIELD 

RP3L 

4 

1 

NUMER 

•LOAD HEAT exchanger PUMP OUTLET* 

field 

RP3A 

4 

1 

NUMER 

•LOAD HEAT EXCHANGER FAN OUTLET*. 

FIELD 

ROPIL 

4 

1 

NUMER 

■COLLECTOR PUMP DIFF PRESS* • 

field 

ROPl A 

4 

1 

NUMER 

■COLLECTOR FAN*. 

FIELD 

RDP2L 

4 

1 

NUMER 

•LOAD HEAT EXCHANGER PUMP*. 

field 

RDP2A 

4 

1 

NUMER 

•LOAD HEAT EXCHANGER FAN*. 

FIELD 

RTl 

4 

I 

NUMER 

•CUTDOQR DRY BULB TEMP*. 

FIELD 

RT2 

4 

1 

NUMER 

•COLLECTOR INLET*. 

FIELD 

RT3 

4 

1 

NUMER 

•COLLECTOR OUTLET*. 

«=IELD 

RT4 

4 

1 

NUMER 

•COLLeCTOR SURFACE* i 

FIELD 

HT6 

4 

I 

NUMER 

•DOMESTIC SERVICE WATER*. 

FIELD 

RT6 

4 

1 

NUMER 

•DOMESTIC PREHEATED OUTLET* « 

FIELD 

RT7 

4 

i. 

NUMER 

•DOMESTIC HOT WATER SUPPLY*. 

FIELD 

RTS 

4 

1 

NUMER 

■STORAGE TANK*. 

field 

RT9 

4 

1 

NUMER 

•DWELLING DRY BULB AIR*. 

FIELD 

ROTl 

4 

1 

NUMER 

♦PREHEATER INPUT DIFF TEMP*. 

FIELD 

RDT2 

4 

1 

NUMER 

■DOMESTIC HOT WATER/SERVICE*. 

FIELD 

R0T3 

4 

1 

numf.r 

•LOAD HEAT EXCHANGER*. 

field 

RO T4 

4 

1 

NUMER 

•COOLING TOWER*. 

field 

RDT5 

4 

1 

NUMER 

•A8S0RBTI0N CHILLER EVAPORATOR*. 

FIELD 

RF 1 

4 

1 

NUMER 

•COLLECTOR FLOW RATE* , 

F lELD 

RF2 

4 

1 

NUMER 

•DOMESTIC HOT WATER*. 

FIELD 

RF3 

4 

1 

NUMER 

•PREHEATER heat EXCHANGE*, 

field 

RF4 

4 

1 

NUMER 

•LOAD HEAT EXCHANGER*. 

FIELD 

RQl 

4 

1 

NUMER 

•COLLECTOR INCIDENCE SOLAR RAD* * 

FIELD 

RWl 

4 

1 

NUMER 

•COLLECTOR PUMP/FAN POWER*. 

FIELD 

RW2 

4 

1 

NUMER 

•DOMESTIC HOT WATER AUX*. 

FIELD 

RW3 

4 

1 

NUMER 

•PREHEATER PUMP/FAN*. 

FIELD 

RW5 

4 

1 

NUMER 

•COOLING TOWER POWER*. 

FIELD 

RTl 

4 

1 

NUMER: 

■LOAD HEAT EXCHNGR PUMP QN/OFF* , 

FIELD 

R 12 

4 

1 

NUMER 

•COOLING TOWER PUMP ON/OFF* . 

F I ELD 

RRHi 

4 

1 

NUMER 

•DWELLING RELATIVE HUMIDITY*. 

FIELD 

RSPl 

4 

1 

NUMER 

•SPARE®. 

FIELD 

RSP2 

4 

1 

NUMER 

•SPARE*. 

FIELD 

RSP3 

4 

1 

. NUMER 

•SPARE* . 

FIELD 

HSP4 

4 

1 

NUMER 

• SPARE* . 

FIELD 

R5P5 

4 

1 

NUMER 

•SPARE*. 


Figure 6.3-1. Fite Structure Statements 
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FIGURE 6.3-1 EXPLANATION 

Structure - This operator must occur firrt in the input, it is used to establish the name of the file to be structured. 

File Name • The name of the file to be structured, it must conform to the name conventions described in Vol. I, 
Introduced to File Concepts. 

FIELD • The field operator must he the first word on the statement defining the characteristics of each data element 
in the data file record. 

Reid Name - A unique name {for the file) that follows the general system name rules. 

Field Length - The EBDIC length of the data field. The entry is coded as a numeric integer, not to exceed three 
characters in length. 

Set Function identifier - This example shows the fields to be Record Control fields. 

Field Mode identifier - This shows that the data field content is alphameric. All control fields must be alpha mode. 

Output Title/Lable - The title or label which will be used in designating the field on output reports. 

GROUP - This operator is used to redefine a sequence of adjacent fields/groups with .. single new name which is to 
be used as a data reference. 

Group Name - The user supplied name for the group of control fields being referenced. 

Group Fields - The names of the fields being grouped together to form the group name. 

Function Identifier - This indicates that this particular field is a control field for Set 1. 

Set Identifier - The 'X' is an indication that the fields shown are data elements (fields) of the fixed set. 

Set identifier - The '1 ' shows that the fields being described are data elements within the first set of the fixed set 
for the file being structured. 
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4*«4i]x4i* NIPS 360 FPS FILE STRUCTURE JQS ijt j(t i> ♦ * + 
FILE NAME- SULUATA ‘ DATE- 76062 









** SOURCE 

STATEMENT LIST M* " 


ruD/GPP 

NAME 

statemc-nt 
OP en AT [JR 

FIELD 
SI ZE 

SPEC 

SET 

NU. 

RfcT. MODE 

LOGIC 

I NPUT 
SUCTRT 

OUTPUT 

SU>3RT 

EDI T 
NAME 

FI ELD /GROUP /VAR. SET 
LAfJEL fCH^RS 1-ftO) 

THE flag ** MARKS 
^ NOTE statements 

ROS ID 

FI ELD 

00 2 

CTL 

000 

- ALPHA 

— 

— 
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Output Report Generation - Terminal 


The applicable terminal application component for use in SIMS is 
the Quick Inquiry Processor (QUIP) , designed to give a powerful 
data retrieval and display capability. 

The Terminal Processing Users Manual (NIPS Vol. VI) contains detailed 
procedures for invoking this terminal application program. An example 
of a terminal session (on a 2260 terminal) is shown in figure 6.3-5. 

File Maintenance - Terminal 


The terminal application program, which provides a means of performing 
maintenance on an existing file, is called Source Data Automation (SODA) 
It interacts with the terminal and the File Maintenance capability , as 
previously described, to alloxj for the inputting of raw data to a file 
or the changing of existing data fields within a file. An example of 
the use of SODA to update two fields of a file is shown in figure 6.3-6, 
along with the previously generated and library stored File Maintenance 
Logic Statements (figure 6.3-7). 

Development Activity - Terminal 


The EDIT application program provides the user programmer/ analyst with 
a means of entering, managing and editing of NIPS source language 
statements for development and debugging. It also provides the user 
the capability of submitting jobs into the input job stream of the 
Operating System for processing. 

Utility Functions - Terminal 

The NIPS system provides the ability to send messages and data between 
terminals and performing the rudimentary utility functions which are 
provided by the System/370 Operating System. 


6.3.5 Information Retrieval 

To support the requirements for both scheduled and non-scheduled inquiries of 
the data base, the Reference and Sort Processor (RASP) of NIFS will be utilized. 
This capability of NIPS provides the following: 

• Batched retrievals against a single file 

• Merged file retrieval 

• Data record qualification on fixed/periodic/variable information 

• Error diagnostic printout 

• Multiple ^ Statements within each retrieval 
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AN EXAMPLE OF THE TERMINAL SESSION TO ACCESS FIVE FIELDS OF A FILE CALLED SOLSTAA IS AS 
FOLLOWS. THE SYMBOL ^ INDICATES 'START MANUAL INPUT', 0 INDICATES 'ENTRY MANUAL 
INPUT' AND Q INDICATES THE REPLY TO THE QUIP REQUEST. 
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AN EXAMPLE OF ATERMINAL SESSION TO EXERCISE THE ON-LINE FILE MAINTENANCE FUNCTION IS AS FOL- 
LOWS WITH THE SYMBOL ^ MEANING 'START MANUAL INPUT', 0 MEANING 'ENTER MANUAL INPUT' 
AND Q INDICATING THE REPLY PRESENTED ON THE TERMINAL SCREEN BY THE SYSTEM 
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Insertion of literals in sort keys 

• Answer record ordering 

e Multiple answer sets from each retrieval 

• Storage of retrievals for later execution 

« Ability to use user - witten subroutines to qualify data 
s Ability to pass information for output formatting 

• Ability to change operands at execution time 

• Ability to change sort field designations to execution time. 

Detailed user instructions are contained in "NIPS Users Manual - Retrieval 
and Sort Processor." 

6.3.6 Output Processing 

In support of the report generation and magnetic tape generation requirements, 
the output processing capability of NIPS will be utilized. This function provides 
the capability for formatting complex and lengthy reports and provides the capa- 
bility to generate graphic output formats. It initializes basic communication 
files and prepares the output data file(s) which are to be processed. The inquiry 
be-'ng processed is examined and any logical conditioning requested to be performed 
on the output is done. Output page formatting statements are processed and made 
ready for compilation and link editing. The final phase of this module is the 
execution of the assembled and linked code against the output data file. 

Formal Report Generation - Hard Copy 

The NIPS „ystem provides the user with a report generator which can 
be driven by a master data file or by the result of a retrieval process. 

A flexible, free form user language is provided. A generative code 
technique produces a Report Instruction Table (RIT) . This module in- 
cludes an automatic library capability for speed and convenience in 
producing non-terminal output. Output may be in the form of print, cards, 
‘ disk or on magnetic tape. An example of the structuring of a RIT and 

the resultant output are shown in figure 6.3-8. 

Detailed user instructions are contained in "MIPS Users Manual - Output 
Processor." 

6.3.7 Plot Capability 


A. capability to plot instrumentation data has been added to the NIPS Data Base 
System- Data will be presented on a Tektronix 4015 display and Irardcopy provided 
on. a Tektronix 4631 unit. The procedure to be utilized in generation of plots is 
as follows: 
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« An information retrieval query is made using NIPS and the NIPS 
terminal processor (TP) through which selected parameters are 
abstracted from the data base for subsequent recall • 

• Using the NIPS TP, a job is submitted from the terminal to the 
host computer which, through the execution of a Data Base Pro- 
cessor, will; 

• Access the retrieved parameters and reformat the data 

• Allow the selection of plot identifiers 

e Pass the plot information to a display interface module 
which will generate the plot on a display terminal. 

Although remote job entry has been mentioned throughout the section concerning 
plot capability batch processing can be used if needed or desired. 

The plot capability is pictorially shown in figure 6.3-9, 
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7.0 COtlPUTER OPERATIONS GUIDEIIHES 


The daily processing of instrtamentafcion data from remote sites Involves com- 
puter operations on both the System/7 computer (data collection) and S/370-145 com- 
puter (data processing/data base update/user support). In addition, non-scheduled 
processing requests must be supported on a continuing basis throughout the con- 
tractual period. Because the majority of daily processing is performed during 
second and third shift, , this section is oriented primarily toward the daily oper- 
ations required in collection and processing of instrumentation data. Other pro- 
cessing requirements will be handled in a normal terminal or batch processing 
environment with no unique operator requirements. 

7.1 SYSTEM/7 DATA COLLECTION OPERATIONS 


At approximately 2000 each night, the data collection process must be initiated 
by the operator. Data collection will process automatically thereafter unless error 
conditions occur which terminate data collection. The following paragraphs describe 
operator actions required in support of Systera/7 data collection. 

7.1.1 Initiation of Site Collection 


To initiate the Data Collection from Remote Sites, the following procedures 
must be followed: 

(1) Mount Disk ’SIMS SYS70P' onto mountable disk unit of System/7 

(2) IPL System/7 from mountable disk 

C3) Upon System Printing ’OPl", enter 'SDC' 

(4) Automatic Data Collection will begin. "Communication Log Report" 
will be printed during collection 

(5) Report of error conditions will be printed during collection. For 
errors causing tejrmination of collection, System/7 programmer must 
he notified 

(Q) Upon completion of Site Data Collection, MESSAGE ’SITE DATA COLLECT 
COMPLETE' will be printed. 

(7) Upon completion of data collection, transfer of data to S/37Q-145 must 
be performed. See Paragraph 7.2 for operation instructions, 

(8) 'Communication Log Report’ must be delivered to computer center for 
inclusion with other data processing reports 

C9) Dismount disk from mountable disk unit and store. 


ORIGINAL PAGE IS 
OPPOOEQUALrUXi 


7.1.2 Monitor o£ Data Collection 


The "Communication Log Report," which Is printed on the Teletype Printer, 
contains a sequential history of communication activity. Error conditions will be 
logged for communications analysis. 

The operator should review this log periodically, and, if an error message 
occurs, he should notify the System/7 Programmer /Analyst for troubleshooting. 

If data collection completes In a normal manner, a message Indicating 
successful completion will be printed. 

7.2 TRANSFER OF DATA TO S/37Q~145 


To transmit data to the S/370-145 for processing and data base update, 
the following operational procedures must he followed: 

CD Insure that the Host Computer operator has invoked the System 
Program 'SBCUPROG' 

(2) IPL from the fixed disk of the System/ 7 

(3) After System/7 Princs enter ’$L!’ 

(4) After System/7 prints 'PGM (NAME,I0DA) : ’ , enter *HFS' 

(5) After System/7 prints ’SBCUPROG STARTED ON HOST?', enter 'X' 

(6) Upon completion of data transfer, Systeia/7 will pring 
'HFS ENDED ’DATE/TQIE' 

(7) Notify Host operator that transfer is complete. 

7.3 REPORT COLLECTION 

Upon successful completion of data transfer, the "Communication Log. Report," 
Data Transfer Message, and other Teletype Messages must be removed from the Tele- 
type Printer and returned to the Facility Computer Room for distribution. The data 
should be placed into the output distribution bin for the Syetem/7 Programmer/ 
Analyst's review the next day. 

7.4 SYSTEM/ 7 RECONFIGURATION 


Since the System/7 computer is shared by other users, the operator must re- 
configure the system to a known state. To perform this reconfiguration, the 
operator must: 

Cl) Dismount 'SIMSSYS70P' disk from mountable disk unit of System/7 
C2) Remote arsn store teletype output 
C3) Store disk into storage cabinet. 
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7,3 S/370-145 DATA TRANSFER FROM SYSTBt/7 


(1) Upon notification by System/ 7 operator, invoke system program 
’SBCOPROG' 

(2) Upon notification by System/7 operator, terminate 'SBCOPROG* 

If error conditions occur to inhibit successful date transfer, the operator 
must notify the Computer Operations Manager for assistance in troubleshooting the 
problem. 

7.6 INITIATION OF INPUT PROCESSING ACTIVITY 

Upon completion of data transfer, the S/370 operator will begin the input 
processing phase by initiating production job "PSIMSIPS" via the console terminal. 

During execution of input processing, the operator will be requested via the 
console to mount tapes and will be notified of error conditions which cause 
termination of processing. Error messages, in addition to system error messages, 
arei 

"SIMS RAW DATA PROCESSING FAILED. CALL INPUT PROCESSING PROG/ANALYST" 

"SIMS MERGE & SUMMARY FAILED. CALL INPUT PROCESSING PROG/ANALYST" 

Successful completion of the Input Processing activity will provide the 
folloxving messages to the operator via the console: 

"SIMS RAW DATA PROCESSING COMPLETED SUCCESSFULLY" 

"SIMS MERGE AMD SUMMARY COMPLETED SUCCESSFULLY" 

"SIMS NIGHTLY IPS SAVES COMPLETED SUCCESSFULLY" 

7.7 DATA BASE MAINTENANCE ACTIVITY 

Upon successful completion, the Data Base Maintenance Activity will be 
initiated automatically by the S/370 operator. If errors occur which cause 
teraination of Data Base Maintenance Activity, the follo:d.ng message will be 
printed on the Console: 

"Data Base Maintenance Terminated. Call Data Base Programmer/ 

Analyst" 

In the event of failure, the operator must dismount SIMS magnetic tapes prior 
to initiation of other jobs to be processed. 

Successful completion of the Data Ease Maintenance Activity will provide the 
following message to the operator: 

"Data Base Maintenance Successfully Completed. Beginning User 

Support Activity" 
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7.8 USER SUPPORT ACTIVITY 


User Support Activity will be invoked by the S/370 operator and will 
provide daily reports for analysis purposes and magnetic tapes for delivery to 
MSEC. Tape mount messages will be provided via the console. 

Unsuccessful completion will be noted through the following console message: 

"User Support Terminated Unsuccessfully. Call Data Base Prog~ 
grammar /Analys t" 

Successful completion will be noted by the following console message: 

"User Support Successfully Completed" 

7.9 REPQRT/MAGHETIC TAPE DISTRIBUTION 


Upon completion of User Support Activities, reports and magnetic tapes 
created, should be placed in output bins for pickup and distribution. 

7.10 TAPE LIBRARIM 


All input and output magnetic tapes used and created during processing must 
be placed in the Tape Library for cataloging. 

7.11 HISTORY PROCESSING 


The IPS History program will be run once a month concurrent with S/7 
data collection operations. The history job must be completed prior to 
initiation of input processing activity (job PSIMSIPS) , 

To run SIMS History the operator shall initiate job "PSIMSHST". 

During History execution, the operator will be requested via the console 
to mount tapes and will be notified of error conditions which cause termination 
of processing. The error message, in addition to system error messages, is: 

"SIMS HISTORY PROGRAM FAILED CALL INPUT PROCESSING PROG/ANALYST" 

Successful completion of SIMS History processing \dLll provide the fol- 
lowing messages to the operator via the console: 

"SIMS HISTORY PROGRAM COMPLETED SUCCESSFULLY" 

"SIMS HISTORY SAVES COMPLETED SUCCESSFULLY" 


8.0 PERFOBtlANCE ANALYST GUIDELINES 


The performance Analyst is a primary user of the GDPS in that he is dependent 
on the GDPS to provide him the data needed to analyze the performance of solar 
heating and cooling systems. The Performance Analyst supports the following 
functions within the GDPS : 

(1) Provides Site Description/ Site Directory information 

(2) Maintains Site Description notebook 

(3) Examines reports generated during processing of raw input data 

(4) Performance evaluation 

The following paragraphs address the role of the Performance Analyst as a user 
of the GDPS. 

8.1 APPLICABLE DOCUMENTS 


The following GDPS documents are required in order to utilize the CDPS : 

(1) CDPS Software Performance Specification Document 

(2) CDPS Software Design Document 

8.2 SITE DESCRIPTION/ SITE DIRECTORY I^nFORZ-IATION 


The Performance Analyst must provide the CDPS with remote site information 
under the following circumstances; 

(1) Initially 

(2) Changing of sensor calibration coefficients 


(3) Deleting a site 


8.2.1 Site Initiation 


In order for the GDPS to automatically collect data, process data, and maintain 
a data base entiry, the Performance Analyst must ensure that the GDPS is initialized 
for the site. This initialization is provided through the completion of the site 
data information form (figure 8-1) . The form consists of three separate sheets and 
should be completed as described in the form. The Performance Analyst must also 
specify performance evaluation equations. The completed form and the equations 
should be taken to the request coordinator who will ensure that the GDPS is pro- 
perly initialized prior to site activation. 

8.2.2 Remote Site Description Ghanges 

The following procedures define the actions to be taken by the Performance 
Analyst to: 

(1) Ghange the general site information 

(2) Update measurement definitions (calibration) 

All forms must be given to request coordinator for implementation. 

General Site Information 


Page 1 of the site data information form contains site general information. 
To correct or update this Information, page 1 must be recorded and given to the 
request coordinator for implementation. 


Measurement Definition Update 

Measurement definition is contained in page 2 and page 3 of the Site Data 
Information Form. To add/change/ delete information previously entered Into the 
system, the lines on the form corresponding to the measurements requiring change 
must be completed as described below: 


Action 


Addition of measurement 


Change of measurement 
characteristics 


Procedure 


Complete line corresponding to 
location of measurement in the 
raw input data stream 

Enter new data into line 
corresponding to measurement 


Deletion of measurement 


Draw a line through the 
location of the measurement 
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SITE DATA INFORMATION 
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CIRCLE 'DELETE' AND COMPLETE SIGNATURE. 


SITE ID (EXAMPLE 00043) 

5 

^ CARD CODES (RESERVED FOR FILE MAINTENANCE TECHNICIAN USE) 

6 7 

SYSTEM TYPE ('HC' - HEATING St COOLING, 'HB = HEATING. OR 'HW' = HOT WATER) 

8 9 

PRINT LEVEL {'12' = MOST DETAILED LEVEL INCLUDES PRINT OF DETAIL RECORDS, 

10 11 '08' - NORMAL LEVEL. '04' = LESS DETAIL THAN NORMAL, 

•OO'^NOPRIK’nNG) 



_ SCAN LEVEL (NO. OF BYTES OF DATA IN ONE SCAN. DO NOT INCLUDE TIME BYTES). 

12 13 

TIME ZONE ('E' = EASTERN, 'C' = CENTRAL, 'M' = MOUNTAIN', 'P' = PACIFIC) 

14 

COLLECTOR AREA (SQUARE FEET, RIGHT JUSTIFY) 

15 19 


Figure 8-t Site Data information Forms (Page 1 of 3} 
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8.2.3 Site D^et j on 

To delete a remote site from the GDPS processing activity, page 1 of the 
Site Data Information Form must be completed as described below: 

Field Current 

bate: Date of deletion 

Status: Circle Delete 

Site ID: ^ Identification of site to be deleted 

•Responsible Signature: Signature of authorized person to add/ 

delete sites 

8.3 MINTAIH SITE DESCRIPTION NOTEBOOK 

The Performance ^alyst must maintain a remote site notebook which contains 
a history of all transactions made to the GDPS relative to the site. The history 
will be provided through listings provided as a result of each remote site 
description file transaction. These listings provide; 

(1) A listing of the composite results of all Site Data Description 
Transactions made to date along with possible error messages 
Csee figure 8-2), Table 6.2-4 contains explanations of error 
messages 

C2) A Site Data Description Report which indicates the present 
contents of the CDPS file (see figure 8-3) 

Through maintenance of previous contents reports and transactions listing, 
traceability can be maintained from initiation to termination of a site, 

8.4 RAW DATA PROCESSIHG ANALYSIS 

The Perfomance Analyst can control the level of detail of print during 
raw input processing. This control is achieved through completion of the 
’’Print Level" field on the Site Data Information Form (figure 8-1) . The 
results to be expected from each selected print level are shown in table 8—1, 
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Description of Kesults 


No site summary report. No detail record prints. 

No messages unless major errors occur. 

Site summary report is printed. No messages about 
individual variable errors (BCH, out of limits, or 
changing too fast.) No detail record prints. 

Site summary report xjith all detailed error messages 
printed. No detail record reports. 

Site summary report with all detailed error messages 
printed. Detail record prints created also. 







The normal output of the CDFS raw data input processing will be the Site 
Raw Data Processing Repoi.t (figure 8-4). Error messages and possible causes/cor- 
rective actions are shown in table 8-2. 

To obtain a listing of all detailed records processed by the CDFS» print level 
12 should be selected. The resulting report will have the format shown in figure 
8-5. 


8,5 SITE PERFORMANCE EVALUATION 


In support of Site Performance Evaluation, the CDFS provides the Performance 
Analyst with daily evaluation reports as shown in figure 8-6. If, upon analysis, 
the Analyst desires further detailed information, the information retrieval 
capability of the Data Base System can be utilized to provide either hardcopy 
reports or plots (examples in figure 8-7). The request coordinator will provide 
the Interface through which the Analyst can request additional information from 
the CDFS. 

8.6 SITE DESCRIPTION FILE GENERATION/MAINTENANCE 


The Data Base File containing the non-instrumented data pertinent to each of 
the sixty remote sites is required to provide data for report generation. The 
performance analyst will complete the Remote Site Description Data Input form 
(figure 8-8) using instructions as detailed in table 8.3. The completed forms 
will be keypunched as detailed in table 8.4, and the resultant cards will be 
input to a batch computer job which will perform the necessary file maintenance 
activity using the NIPS File Maintenance (FM) capability. This file maintenance 
will be performed on an as required basis as site information is added/deleted/ 
changed. 

8.7 SUBSYSTEM EVALUATION FILE GEI^ERATION/MAINTENANCE 


The Subsystem Evaluation File is a manually maintained file containing characterls 
tics of the subsystems being evaluated. The performance analyst will complete the 
'Subsystem Evaluation Input Sheet' (figure 8-9) per Instructions detailed in table 
8.5. The completed forms ^rf.11 be keypunched per the keypunch instructions of 
table 8.6. The generated catds will be input to a NIPS/360 File Maintenance (FM) 
process on an as required basis (TBD) . 

8.8 SYSTEM INTEGRATION D.ATA FILE GBMER.VIION/ttAIMTENAMCE 

TBD 

8.9 SIHULATION/WEATHER DATA FILE GEMERATION/HAIMTERAKCE 

TBD 
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Figure 8-4- Sample Raw Data Processing Site Summary Report 


FOR SDAS 041 



J^VAtUE H!N_V At.OE_TIMe 
0*000 77/11/14 07*38*25 
0.000 77/11/14 09*35.45 
0*000 77/11/14 07.38*23 
0.000 77/11/14 07*38*25 
0*000 77/11/14 07*38*25 
0.000 77/11/14 07*38*25 
0*000 77/11/14 07*38*25 
0.000 77/11/14 07*38*25 
0.000 77/11/14 07*38*25 
0*000 77/11/14 07*38*25 
0*000 77/11/14 07*36*25 
O.OCO 77/11/14 07*38*25 
0.000 77/11/14 07*38*25 
0.000 77/11/14 07.43.43 
0-000 77/11/14 07.3S.25 
0*000 77/11/14 07*38*25 
0*000 77/11/14 07.43*45 
0*000 77/11/14 07.38*25 
0.000 77/11/14 07*38.25 
0.000 77/11/14 07*38*25 
0*000 77/11/14 07*38*25 
O.OCO 77/11/14 07*38*25 
0.000 77/11/14 07*38*25 
0*000 77/11/14 10*23*45 
0.000 77/11/14 18*14*09 
15.347 77/11/14 14*23.45 
66.543 77/11/15 00*16.49 
71.554 77/11/15 00-59.29 
93.734 77/11/14 11*11*45 
66*680 77/11/14 23*50*09 
0.000 77/11/14 07*38.25 
0.000 77/11/14 07*38*25 


MAX^VALOE «AX_VALUE_T1MH 

0*000 77/12/24 07*38.25 
0*C96 77/11/14 11*01*05 
0.000 77/11/14 07*38*25 
286*£47 77/11/14 13*09*05 

2.000 77/11/14 08*42.25 
2*000 77/11/14 11*02*05 
2.C00 77/11/14 07*43*45 

2.000 77/11/14 09*57*05 
2*000 77/11/14 10*07*45 
. 2.000 77/11/14 l6*42i.2S 

2.000 77/11/14 13.57.05 
2*000 77/11/14 06*37*05 
2*000 77/11/14 11*17*08 

2.000 77/21/14 12*37.05 

2.000 77/11/14 12*21.05 
2.0C0 77/11/14 09*30*25 
2*000 77/11/14 Ofi.53.05 
2*000 77/11/14 09*41*05 

2.000 77/11/14 08*37*05 
2.QC0 77/11/14 08*31 *41 
2-000 77/11/14 09*57.05 
2.0G0 77/11/14 07*57.45 
2.00C 77/11/14 10.39*45 
23.705 77/11/14 13. 19.45 
34*897 77/11/14 08*37.05 
43*986 77/11/14 23*55.29 
75.660 77/11/14 16*05.05 
125.181 77/21/14 16*10.25 
125.970 77/11/14 16.Z0.25 
85.S13 77/11/14 16*15.45 
0.000 77/12/14 07*38.25 
2*358 77/11/IS 00*22.09 
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Table 8.2. Raw Data Processing Error Messages (Sheet 1 of 6) 



Message: MO SITE DATA DESCRIPTION RECORD FOR SITE . DATA FOR THIS 

SITE BYPASSED. 

Error Level; 12 Subroutine; IPSRAN (Main) 

Explanation: Raw data with a site id for which there is no record in the 

Site Data Description file. Either the raw data is wrong, or 
the Site Data Information for the site must be added to the 
Site Data Description file . 


.‘lessage: SITE IS A SITE WITH MO PREVIOUS DATA. 

Error Level: None Subroutine; IPSRAW (Main) 

Explanation: No record for the site was found in the continuity file. This 

means that the current hatch of raw data contains the first 
operational data collected from the site. 


Message: LOST LM RAW FILE. SITE ID RECORD HAS WRONG FILL PROCESSING 

.'^TOPPED. 

Error Level; 16 Subroutine; IPSRAW (Main) 

Explanation: Raw data has wrong format or some data is missing. Consult 

with System/7 programmers for possible problem explanation. 
(Site id record content is printed.) 


Message: 'IICULLAR V.ALL’ES IN TIME OF SITE ID. DATA PROCESSING FOR THE SITE 

WILL 3E BYPASSED. PROCESSING FOR OTHER SITES WILL BE ATTEMPTED. 

Error Level: 12 Subroutine: IPSRAW (Main) 

Eiiplanation: Either System/7 put bad values in Site id record or this is 

not a site id record. If record also ha.s had fill data or 
bad counters it is prohahiy not an id record. Consult with 
System/7 programmers for possible problem explanation. (Site 
id record content is printed.) 


Mess.ige: "-Ml VALUE(S) IN COl'NIEK.'; uip ID KSCORD. PROCESSING STOPPED. 

Error Level: 16 Subro-t r r^SPAW (Main) 


Explanation : 


Either System/ 7 put bad value (s) in Site id record or this is 
not an id record. If record also has bad fill data or bad 
time values it is prob.i'oly not an id record. Consult with 
System/7 programmers for possible error explanation. (Site 
id record content is printed.) 
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Table 8,2, Raw Data Processing Error Messages t.bneec or o; 


Message: HIGHEST SEVERITY LEVEL 

Error Level: Not applicable Subroatine: IPSRAW (Main) 

Explanation: If 16, terminal error encountered. If 12, processing, failed 

for one or more sites. If 10, one or more data blocks 
rejected. If 8, one or more scans rejected. If 4, one or 
more individual variable readings rejected. If 0, no data 
rejected . 

Message : l-NEXPECTED K.ND OF FILE OF RAW DAT.4 UHILE SEP.4RATING RAW DATA OF 

SITE INTO DATA AND FLAG STREAMS. 


F>ror Level : 16 


Subroutine: STREAM 


Explanation: Site id record must have a bad value in its counters or some 

raw data has been lost. Consult with Systen/7 programmers 
for possible error explanation. 

Message: HiXlMSEP : END UF FILE RESIDING DATAFiT. PROCESSING STOPPED FOR 

SITE 


Error Level : 12 


Subroutine: SCANSE^ 


E;-;pl.:nat iot End-of-site indication not found in the data records for the 
site. If BCH error count for the site was not zero then 
probably a noise problem made an End-of-block or End-of-site 
unrecognizable. 

Message : Eu.ANSEP. END OF FILE READING FL^\GFIL. PROCESSING STOPPED FOR 

'''TTE 


Error Level; 12 


Subroutine: SCANSEP 


Explanation: Noritally accompanies an ’END OF FILE READING DATAFIL' message 

and is part of the same problem. 


Message: SCANSEP. A COMMAND FRAME M\S ILLEGAL CODE AND NO BCH ERROR. PRO- 
CESSING STOPPED FOR SITE ID 


Error Level: K 


Sub rout 


SCrVNSEP 


Explanation: Either raw data has wrong format or the scan separation 

routine has gotten lost processing noisy data. Look at site 
BCH error count and consult with System/7 programmer for 
problem explanation. 
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Table 8.2. Raw Data Processing Error Messages (Sheet 3 of 6) 




Message: SCAN3EP: A SCAN tvITH TIME HAS BEEN DROPPED SINCE TIME 

< = TIME OF LAST SCAN. SITE ID = 


Error Level: 8 Subroutine: SCANSEP 

Explanation: Error could be caused by rerunning same raij data and not re- 

storing to previous version of continuity file. Otherxjise, 
time may be wrong or time of previous scan may be wrong. 

Message: SCANSEp"; A SCAN WITH TT>1E HAS RKFM DROPPPP STMr.E TT>fF. 

> = RUN TIME. SITE ID = 

Error Level: 8 Subroutine; SCANSEP 

E:<planaUion : Could be caused by a clock reset at the site. .Also could be 

connected to a time overrun at the site. 

TiessaTTT” sia.NSEP: BCH ERROR IN CO^iHA^^D FRA^E WITH END-OF-SITE CO^DLA:^iD 

c'U'! SITE ID 

Error Level: 10 Subroutine: SCx\NSEP 

Exp lauatio:: : Noisy data. Command is treated as End-of-site. If command 

should have been Block-Start then one or more data blocks were 
lost. Compare SCANSEP actual and expected raw data byte counts. 

i 

Messa"”: jrAN'SEP: BCH ERROR IN COlDhVND FRAME WITH BLOCK START COIC-LAND CODE. 

-CK OF DATA SKIPPED FOR SITE ID 

Error Level: iO Subroutine: SC.ANSEP 

Explanation: Noisy data. Command with BCH error treated as Block Start. 

Normally means a block of data is rejected. If should have 
been End-of-site then will probably end up rejecting all data 
for the site. 


Message; SCANSEP: COIDIAND WITH BCH ERROR A.MD ILLEGAL CODE ASSUMED TO BE 

BLOCK START. BLOCK WILL BE SKIPPED FOR SITE 

Error Level: 10 Subro-'t ' ->6 ‘ SCANSEP 

Explanation: Similar to BCH error i.' • i- frame with Block t r t con‘'.ind 

code. 
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Message; CNVTEST: BAD NIPS POIllTER FOR SITE PROCESSING FOR 

SITE STOPPED. 


Error Level: 12 Subroutine: CNITEST 

Explanation: Sad information in the S'" • ’''.r-i Description file. Change 

values on the Site Data > ir'tion form and/or c'’an;:e the 

Site Data Description L'tility. 
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Table 8,2. Raw Data Processing Error Messages (Sheet 5 of 6) 


Message: IN CNVTEST HAVE SITE ID MSMATGH. 

SITE-DATA-INEO. SITE-ID = SCAN SITE-ID 

NIPS-INPUT. SITE-ID =__ PROCESSING TERl'IINApD. 

Error Level: 16 Subroutine GNVTEST 

Explanation: Should never happen. Look for: a software problem. 


Message; CNVTEST; ILLEGAL CONVERSION TYPE IN SITE DATA INFO. PROCESSING 
STOPPED FOR SITE ID 

Error Level: 12 Subroutine: CNVTEST 

Explanation: Bad information in the Site Data Description. ‘file. Change 

values on the S Lte Data Information form and/or change the 
Site Data DescripCion Utility. 

Message : \L\RIABLE OI.IT OF T.TMTTS AT TnfE ^ 

MI.N1MUM = ' ■ FL^XIMUH = ______ VALU E = ' 

Error Level; None Subroutine; CNVTEST 

Explanation; Engineering units value of variable is outside of performance 
analyst specified limits. 


Message: VARIABLE HAS BCH ERROR AT TIME. 

Error Level : None Subroutine: CNl.'TEST 

Explanation; A BCH flag error affects the portion of the raw data from 

which the variables data was extracted. The value could be 
wrong. 


Message: VARIABLE CHA.NGED TOO FAST AT TIME 

Error Level; None Subroutine; CNVTEST 

Explanation: Change between successive values of a variable exceeds per- 

forraance analyst specified limits. 

Message ; VARIABLE RE JECIED A f ‘ “ 

Error Level: 4 Subroutine: CNVTEST 

E:tplanation : Variable failed two or more tes ts Cout-of-Iiraits , BCH error , 

or changing-top“ fast) and value was lejected. 


UJttlGINAL PAGE IS 
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SOLAR HEATING AND COOLING PROGRAM 


0.rtJ 

Ci’^ 

’a'£» 


ERDA1-0D37 

12/16/76 DAILY SYSTEM PERFORMANCE SUMMARY 


PROCESSING DATE: JANUARY 4. 1976 


SITE NUMBER: 0037 

SITE LOCATION: 

SITE NAME; 

OPERATION START DATE: OCTOBER 1 7, 1976 
LATITUDE; 34.7“N 

LONGITUDE: 86.60N 


1915 WAXLEAF GREEN, HUNTSVILLE, ALABAMA 35803 


COLLECTOR SIZE; 65 SQUARE METERS 

COLLECTOR TYPE; REVERE COPPER 
STORAGE SIZE: 1200 GALLONS 

STORAGE MEDIA: 100% WATER 


SYSTEM TYPE; 


HOT WATER,HEATING & 
COOLING 


DATE OF DATA: DECEMBER 16. 1975 


I -X 1 1 i 

' t HOTWATER | HEATtNG I COOLING I 

hour h--7 j 1 1 

OF ■ 
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OAV 

( J 

0-1 
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I I I > 
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20 
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Table 8.3. Remote Site Description Data Input Sheet(s) 

Page 1 Instructions 


Complete page 1 of the remote site description data input sheet using the following 
instructions for each information block on the form. 


BLOCK HEADING 

SITEID 

SYSID 

SITE NAME 

STREET ADDRESS 

CITY, STATE, UP CODE 

LATITUDE 

LONGITUDE 

ROOF PITCH 

ORIENTATION 

DESIGN LOAD 

POWER COST 

AUXILIARY SYSTEM 


BLOCK HEADING 
IDENTIFICATION 
MFG. CODE 
MATERIAL CODE 
TYPE (LI/AI) 
SYSTEM TYPE 


General Information 

Instruction 

2 character Site Identification Number 

2 Character System Identification Number 

Up to 50 Character Site Name 

Up to 50 Character Street Address of the Site 

Up to 50 characters for City, State, and Zip Code 

Up to 10 character of Latitude Information 

Up to 10 characters of Longitude Information 

Up to 2 characters showing pitch of roof 

Up to, 2 characters indicating building orientation 

Up to 12 characters of design load information 

Up to 10 characters of cost of power 

Up to 20 characters indicating auxiliary system used 

Collector Subsystem 

Instruction 

2 characters of Collector Subsystem Identifier 
2 character manufacturers code 
2 character code for material 
LI for Liquid or AI for Air 

SF-single family or MF-Multiple Family or CO-conmercial 


OBIGMMi PAGE IS 
OP POOR QUALEUr 
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Table 8,3. Remote, Site Description Data Input Sheet(s) (Continued) 
Page 2 


BLOCK HEADING 
COST CATEGORY 
MANUFACTURERS NAME 

ABSORBER MATERIAL 
ABSORBER CONFIGURATION 

ABSORBER COATING 
NO. OF COVERS 
COVER MATERIAL 
POWER SIZE 
STATUS (AS-LP) 

CERTIFY CODE 
OPERATING LIFE 
RATED ENERGY 
INLET TEMP. 

OUTLET TEMP. 

FLOW RATE 


Instructions (Cont*d) 

EC-Economic or MR-Marginal or UN-Uneconomical 

Up to 20 characters for name of Collector System 
manufacturer 

Up to 20 characters describing the absorber material 

Up to 20 characters describing the configuration of 
the absorber 

Up to 10 characters describing absorber coating 

2 characters indicating the number of covers 

Up to 10 characters describing cover material 

Up to 10 characters showing standard power size 

Operational status, AS-available off shelf or LP- 
limited production 

2 character independent agency certification code 
2 character operating life code 
2 characters indicating Energy Collection (Rated) 

Up to 4 characters of collector inlet temperature 
Up to 4 characters of collector outlet temperature 
Up to 4 characters indicating collector flow rate 
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Table 8.3. Remote. Site Description Data . Input Sheet(s) (Continued) 
Page 3 


BLOCK HEADING 
RECORDING FORMAT 
NO. OF PARAMETERS 
DATA SET NAME 


BLOCK HEADING 
ID 

TYPE 

COf^ERCIAL ID 
DIMENSION 
THERMAL CAP 
RATED TEMP 
RATED PRESSURE 
BURST PRESSURE 
PRESSURE RANGE 

BLOCK HEADING 
ID 

MATERIAL ID 
FLUID ID 
SAFETY CODE 


SPAS DATA 

Instruction 

1 character showing format of SDAS recording 

Up to 4 characters indicating number of parameters 

Up to 8 characters showing the remote operational 
data set name 

STORAGE SUBSYSTEM 

Instruction 

2 character storage subsystem identification 
2 character storage type 

2 character storage commercial identification 
10 characters showing storage dimension 
2 characters of rated thermal capacity 
Up to 4 characters of rated temperature 
Up to 4 characters showing rated pressure 
Up to 4 characters showing burst pressure 
Up to 10 characters indicating pressure range 
COOLING SUBSYSTEM 

Instruction 

2 character cooling subsystem identification 
2 character identification of material 
2 character identification of fluid 
2 character safety code 


ORIGINS 
OF POOR 


Table 8.3. Remote. Site Description Data Input Sheet (s) CContinued) 
■ Page 4 


BLOCK HEADING 
PERFORMANCE DATA 

BLOCK HEADING 
ID 

MATERIAL ID 
TYPE 
COMM. ID 
SAFETY CODE 
PERFORMANCE DATA 

BLOCK HEADING 
ID 

LOGIC ID 
PARAMETERS 
SENSOR TYPES 
OPERATING MODES 

BLOCK HEADING 
ID 

TYPE 


COOLING SUBSYSTEM (Cont'd) 

Instruction 

Up to 80 characters of performance data 
HEATING SUBSYSTEM 

Instruction 

2 character identification of the heating subsystem 

2 character identification of material 

2 character heating type indicator 

2 characters of commercial identification 

2 character safety code 

Up to 80 characters of performance data 

CONTROL SUBSYSTEM 

Instruction 

2 character identification of the control subsystem 
2 character identification of logic 
Up to 80 characters of parameter data 
Up to 80 characters showing sensor types 
Up to 80 characters indicating operating modes 
HOT WATER SUBSYSTEM 

Instruction 

2 character identification of this hot water subsystem 
2 character indicating type of subsystem 


Table 8.3. Remote Site Description Data Input Sheet(s) (Continued) 
Page 5 


HOT WATER SUBSYSTEM (Cont'd) 


BLOCK HEADING Instruction 

COMMERCIAL ID 2 characters of commercial identification 

FLUID INTERFACE SEPARATION 2 characters of fluid separation 

TOXICITY POTENTIAL 2 character codes showing toxicity 

SAFETY STANDARD 2 character code indicating safety standard 

TRANSPORT SUBSYSTEM 


BLOCK HEADING 
ID 

COMMERCIAL ID 
DESCRIPTION 


Instruction 

2 character identification of the transport subsystem 
2 characters of commercial identification 
Up to 200 characters of descriptive data 


original page is 
OP POOR QUAW3® 
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_ _Remote^ Si te Descri pti on _pata Input Sjieet{s) (Continued) 

Page 6 


Page 2 Instructions 

Page 2 can contain up to 1000 characters commentary text such as; 

0 Failure history 

- Problem/Date 

- Problem/solution date 

0 Pointers to off line documents/data 

- System description 

- System definition 

- System specification 

- Design procedures 

- Ceritifi cation data 


Table 8,3. Remote Site Description Dat^Input Sheet(s) (Continued) 
Page 7 

Page(s) 3 and above instructions 


Complete a two line entry for each parameter being received from the SDAS. Use 
as many pages as required. 


BLOCK HEADIMG 
FIELD NAME 
SIZE 

SET NUMBER 
MODE 

CONVERSION ROUTINE-INPUT 
CONVERSION ROUTINE-OUTPUT 
EDIT MASK 
-ABEL 

GROUP (Y/N) 

DUMMY (D) 

SYSTEM ID CODE 


SDAS PARAMETER DATA 

Instruction 

Up to 7 characters of a unique field name 
2 characters showing size of the parameter in bytes 
2 characters indicating set in remote data file 
5 characters indicating made-either ALPHA or NUMBER 
Up to 7 characters giving name of input routine 
Up to 7 characters giving name of output routine 
Up to 7 characters showing name of edit mask used 
Up to 69 characters labeling the parameter 
Group indication either Yes (Y) or No (N) 

Dummy record indicator - D 
Subsystem identification character 


omgii^ai; page? js 
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JOB NUMBER; 

3 NAME; Remote Site Description Data Input Sheet 1 


EFFECTIVE DATE. 


qpc ” 


L 






CAftDCOL- 

NO. OF COt*S 

FIELD OESCRIPTION 

SPECIAL INSTRUCTIONS 

1 

1 

Transaction 

Always *D' 

2 

2 

Card Code 

Always '01' •• 

4 

5 

Site ID 

AN, RJZF if less than 2 positions 

9 

2 

System ID 

AN, RJZF if less than 2 positions L 

11 

69 

Site Name 

AN, LJ, punch as shown 



Card 2 


1 

i 

Transaction 

Always 'D' 

2 

2 

Card Code 

Always '02' 

4 

5 

Site ID 

Dupe from Card 1 

9 

2 

System ID 

Dupe from Card 1 

11 

69 

Street Address 

AN, LJ, punch as shown 



Card 3 


1 

1- 

Transaction 

Always 'D' 

2 

2 ^ 

Card Code 

Always '03' 

4 

5 

Site ID 

Dupe from Card 2 

9 

2 

System ID 

Dupe from Card 2 

11 

69 

City, State, Zip Code 

AN, LJ, punch as shown 



Card 4 

* 

1 

1 

Transaction 

Always 'D* 8 

2 

2 

Card Code 

» T 

Always '04' 

4 

5 

Site ID' 

Dupe from Card 3 

9 

2 

System ID 

Dupe from Card 3 

11 

10 

Latitude 

A/N, LJ, punch as shown 



138 

- 




''i 


J 


1 











KEYPUNCH OPERATING INSTRUCTIONS 


JOB NUMBER: 

3 NAME: Remote Site Description Data Input Sheet 1 


EFFECTIVE DATE; 


I I CARO COL. InO. OFCOL'Si 


FIELD OESCRIPTION 


Card 4 (Continued) 


Longitude 
Roof Pitch 
Orientation 
Design Loads 
Power Cost 
Auxilary System 


SPECIAL INSTRUCTIONS 


AN, LJ, punch as shown 
A/N, RO, reject greater than 2 

AM, RJ, reject greater than 2 

AN, RO, punch as shown 
AN, Rj punch as shown 

t 

AN, RJ punch as shown 


Card 5 
Transaction 
Card Code 
Site ID 
System ID 
Identi fication 
Mfg. Code 
Material Code 
Type (LI/AI) 

Type (C) 

System Type 
Cost Category 
Efficiency Code 
Manufacturer’s Name 
Absorber material 
Absorber configuration 


Always 'D' 

Always *05' 

Dupe from Card 4 
Dupe from Card 4 
AN, RJZF 
A/N, RJZr 
A/N, RJZF 
A/N, RJZF 
A/N-Always 'C‘ 

A/N, Skip of blank 
N. skip if blank 
A/N, skip if blank 

A/N, LJ, punch as shown 

A/N, LJ, punch as shown 

A/N, LJ, punch a", :hown‘ 


o:UG!i)AL BfLGB B . 

0? BOOB QlIAIOT 


aowBti; 


KEYPUNCH OPfRAtiNG^^m^^ 


JOB NUMBER. 
3 NAME; 


PAGE_ 


EFFECTIVE DATE; 



CARO COU 

NO, OF COL*S 

FIELD DESCRIPTION 

SPECIAL INSTRUCTIONS 


Card 6 

Transaction Code 
Card Code 
Site ID 
System ID 
Absorber Counting 
No. of Covers 
Cover Material 
Power Size 
Status (AS-LP) 

Certify Code 
Operating Life 
Rated Energy 
Inlet temp 
Outlet temp 
Flaco Rate 
Recording Format 
No. of Parameters 
Data Set Name 

Card 7 (Storage Subsystem) 
Transaction Code 
Card Code 
Site ID 


Always *D' 

Always 06 
Dupe from Card 5 
Dupe from Card 5 
AN, LJ, punch as shown 
AN, RJZF 

AN, LJ, punch as shown 
AN, LJ, punch as shown 
AN, punch as shown 
AN, LJ, punch as shown 
AN, LJ, punch as shown 
AN, LJ, punch as shown 
AN, RJZF, skip If blank 
AN, RJZF, skip if blank 
AN, RJZF, skip if blank 
AN, skip if blank 
AN, RJZF, skip if blank 
AN, LJ, punch as shown 

Always *D' 

Always '07* 

Dupe from Card 6 








KEYPUNCH OPERATING INSTRUCTIONS » 7 

PAGE OP / ; 

lOB NUMBER: 


EFFECTIVE DATE; 

BNAME: 




CARD COL. 

NO. OP COL<S 

FIELD OESCmPrrON 

SPECIAL INSTRUCTIONS 



(Card 7 Cont'd) 


9 

2 

System ID 

Dupe from Card 6 

11 

2 

ID 

AN, LJ skip if blank 

13 

2 

Type 

AN, LJ skip if blank 

15 

2 

Commercial ID 

AN, LK skip if blank 

17 

10 

Dimension 

AN, LJ skip if blank • 

27 

2 

Thermal Cap 

AN, LJ skip if blank 

29 

4 

Rated Temp 

AN, LJ skip if blank 

33 

4 

Rated Pressure 

AN, LJ skip if blank 

37 

4 

Burst Pressure 

AN, LJ skip if blank 

41 

10 

Rated Range 

AN, LJ skip if blank 



Card 8 (Cooling Subsystem) 


1 

1 

Transaction Code 

Always ’D' 

2 

2 

Card Code 

Always *08‘ 

4 

5 

! 

Site ID 

Dupe from Card 7 ? 

9 

2 I 

System ID 

Dupe from Card 7 

11 

i 

2 : 

ID 

AN, skip if blank 

13 

2 

Material ID 

AN, skip if blank 

15 

2 

Fluid ID 

AN skip if blank , 

* '■>: ■ 

17 

2 

Safety Code 

AN, skip if blank 

19 

51 

Performance Data 

AN, LJ, skip if blank 
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PAGE 5 OF 7 


JOB NUMBER; 
■ 'NAME. 


EFFECTIVE DATE; 


CARD COL. NO. OF COL*S 


FIELD DESCRIPTION 


SPECIAL INSTRUCTIONS 



Card 9 (Heating Subsystem! 
Transactron Code 
Card Code 
Site ID 
System in 


Material ID 


Type 
Comm. ID 
Safety Code 
Performance data 


Card 10 (Control Subsystem^ 
Transaction Code 
Card Code 
Site ID 
System ID 


Logic ID 
Parameters 


Card II (Control Subsystem 
tont^d 

Transaction Code 
Card Code 


Always D 
Always '09' 

Dupe from Card 8 
Dupe from Card 8 
AN, Skip if blank 
AN, skip if blank 
AN, skip if blank 
AN, skip if blank 
AN, skip if blank 
AN, LJ, skip if blank 


Always 'O' 

Always '10* 

Dupe from Card 9 
Dupe from Card 9 
AN, skip if blank 
AN, skip if blank 
AN, LO skip if blank 


Always *D' 


Always *11' 


OMGINAL PAGE IS 
OE POOE QUALITY 










KEYPUNCH OPERA HNG INSTRUCTIONS 6 7 

PAGE OF ^ 

JOB NUMBER: 
NAME; 


EFFECTIVE DATE' 

i 

CARO COL, 

NO. OF COL'S 

FIELD DESCRIPTION 

SPECIAL INSTRUCTIONS 






Card 11 (Control Subsystem Cont'd 


Site ID 
System ID 
Sensor Types 


Card 12 (Control Subsystem Cont'd) 


Transaction Code 
Card Code 
Site ID 
System ID 
Operating modes 


Card 13 (Hot Water Subsystem 


Transaction Code 
Card Code 
Site ID 
System ID 
ID 

Type 

Commercial ID 

Fluid Interface Separation 
Toxicity Potential 
Safety Standards 


Dupe from Card 10 
Dupe from Card 10 
AN, LJ punch as shown 


Always 'D' 

Always '12' 

Dupe from Card 11 
Dupe from Card 11 
Ail, LJ, punch as shown 


Always 'D* 

Always '13' 

Dupe from Card 12 
Dupe from Card 12 
AN, skip if blank 
AN, skip if blank 
AN, skip if blank 
AN, skip if blank 
AN, skip if blank 
AN, skip if blank 
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JOB NUMBER. 
NAME. 


CARO COU 







Card 14 (Transport Subs.vsteml 

Transaction Code 

Card Code 

Site ID 

System ID 


Commercial ID 
Description 


Card 15 (Transport Subsystem. Cont! 

Transaction Code 

Card Code 

Site ID 

System ID 

Description Cent. 


EFFECTIVE DATE 


SPECIAL INSTRUCTtONS 


Always 'D' 

Always *14' 

Dupe from Card 13 
Dupe from Card 13 
AN, skip if blank 
AN, skip if blank 
AN, LJ, punch as shown 


Always 'D' 

Always '15' 

Dupe from Card 14 
Dupe from Card 14 
AN, LJ, punch as shown 
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Tadie B.b. v^neex i or d; 


Subsystem Evaluation Input Sheet 

Complete the subsystem evaluation input sheet using the following instructions for 
each information block on the form. 

General Information 


BLOCK HEADING 


HOUR 


NO. OF SAMPLE 
DATA SOURCE 


SUBSYSTEM 


BLOCK HEADING 


IDENTIFICATION 
MFG. CODE 


MATERIAL CODE 


SYSTEM TYPE 
COST CATEGORY 
MANUFACTURERS NAME 


ABSORBER MATERIAL 
ABSORBER CONFIGURATION 
ABSORBER COATING 
NO. OF COVERS 
COVER MATERIAL 
PANEL SIZE 


STATUS 


Instruction 

Month, Day, Year of Input 
2 character hour of evaluation data 
2 characters indicating number of samples 

1 character denoting source of data 

4 character subsystem identification ‘ 

Collector Subsystem 
Instruction 

2 characters of Collector Subsystem Identifier 
2 character manufacturers code 

2 character code for material 
LI for Liquid or AI for Air 

SF-Single Family, MF-Multiple Family or CO-Ccrrmercial 

EC-Economic, MR-Marginal or UN-Uneconomical 

Up to 20 characters for name of Collector Subsystem 
manufacturer 

Up to 20 characters describing the absorber material 

Up to 20 characters describing the configuration of the absorber 

Up to 10 characters describing absorber coating 

2 characters indicating the number of covers 

Up to 10 characters describing cover material 

Up to 10 characters showing standard panel size 

Operation Statu;, AS-available off shelf or 
LP- limited production 
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BLOCK HEADING 
CERTIFY CODE 
OPERATING LIFE 
RATED ENERGY 
INLET TEMP. 
OUTLET TEMP. 

FLOW RATE 

BLOCK HEADING 
ID 

TYPE 

COMMERCIAL ID 
DIMENSION 
THERMAL CAP 
RATED TEMP. 

RATED PRESSURE 
BURST PRESSURE 
PRESSURE RANGE 
PERFORMANCE DATA 

BLOCK HEADING 
ID 

MATERIAL ID 
FLUID ID 
SAFETY CODE 
PERFORMA.NCE DATA 


Collector Subsystem (Cont*d) 

Instruction 

2 character independent agency certification code 
2 character operating life code 
2 characters indicating Energy Collection (Rated) 
Up to 4 characters of collector inlet temp. 

Up to 4 characters of collector outlet temp. 

Up to 4 characters indicating Collector Flow Rates 
Storage Subsystem 

Instruction 

2 character Storage Subsystem identification 
2 character storage type 
2 character commercial identification 
10 characters showing storage dimension 
2 characters of rated thermal capacity 
Up to 4 characters of rated temperature 
Up to 4 characters showing rated pressure 
Up to 4 characters showing burst pressure 
Up to 10 characters indicating pressure range 
Up to 80 characters of performance data 
Cooling Subsystem 

Instruction 

2 character Cooling Subsystem Identification 
2 character identification of material 
2 character identification of fluid 
2 character safety code 
Up to 80 characters of performance data 
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Table 8.5. TSheet 3 of 3) 


BLOCK HEADING 
ID 

MATERIAL ID 
TYPE 
COMM ID 
SAFETY CODE 
PERFORMANCE DATA 

BLOCK HEADING 
ID 

LOGIC ID 
PARAMETERS 
OPERATING MODES 

BLOCK HEADING 
ID 

TYPE 

COMMERCIAL ID 

FLUID INTERFACE SEPARATION 
TOXICITY POTENTIAL 
SAFETY STANDARD 


Heating Subsystem 

Instruction 

2 character identification of the Heating Subsystem 

2 character identification of material 

2 character heating type indicator 

2 characters of commercial identification 

2 character safety code 

Up to 80 characters of performance data 

Control Subsystem 

Instruction 

2 character identification of Control Subsystem 
2 character identification of logic 
Up to 80 characters of sensor types 
Up to 80 characters indicating operating modes 
Hot Water Subsystem 
Instruction 

2 character identification of Hot Water Subsystem 
2 characters indicating type of system 
2 characters of conrniercial identification 
2 characters of fluid separation 
2 character code showing toxicity 
2 character code indicating safety standard 
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JOB NUMBER, 

'NAME: Subsystem Evaluation Input Sheet 

EFFECTIVE DATE ■ 

CAROCOU 

NO. OF COl_'S 

FIEUO description 

■ i 

1 

SPECIAL INSTRUCTIONS ] 

,, 





Card 1 
Transaction 
Card Code 
Date 
Hour 

Number of Sample 
Data Source 
Subsystem 

Card Z (Co. lector Subsystem) 
Transaction 
Card Code 
Subsystem 
Identi fi cation 
Manufacture '^'s Code 
Material Code 
Type 

■TY (always 'C') 

System Type 
Cost Category 
Efficiency Code 
Manufacturer's Name 
Absorber Material 


Always 'D‘ 

Always '01' 

A/N 

A/N 

A/N 

A/N 

A/N 

Always 'D' 

Always '02' 

From cols. 15-18 of card 1 
A/N, RJZF 

A/N, skip if blank 
A/M, skip if blank 
A/N, skip if blank 
Always 'C 
A/N, skip if blank 
A/N, skip if blank 
A/N, skip if blank 
A/H, LJ, punch as shown 
A/N, LJ, punch as shown 









KEYPUNCH OPERA! ING INSTRUCTIONS 


PAGE 2 Oi 


JOBNUMBER; EFFECTIVE DATE . 

NAME; Subsystem Evaluation Input Sheet 


RD COU 

NO. OF COL’S 

FiELD OESCPUPTION 

SPECIAL INSTRUCTIONS 

1 

1 

Card 3 (Collector Subsystem 
Continued) 

Transaction 

Always 'D' 

2 

2 

Card Code 

Always ‘03' 

4 

4 

Subsystem 

From cols. 15-18 of card 1 

8 

20 

Absorber Configuration 

A/N, LJ, punch as shown 

28 

10 

Absorber Coating 

A/ri, LJ, punch as shown 

38 

2 

Number of Covers 

A/N, RJZF 

40 

10 

Cover Material 

A/N, LJ, punch as shown 

50 

10 

Panel Size 

A/N, LJ, punch as shown 

60 

2 

Status 

A/N, skip if blank 

62 

2 

Certify Code 

A/N, skip if blank 

64 

2 

Operating Life 

A/N, skip if blank 

•66 

4 

1 

Rated Energy 

A/N, skip if blank 

70 

3 

Inlet Temperature 

A/N, skip if blank 

73 

3 

Outlet Temperature 

A/N, skip if blank 

76 

4 

Flow Rate 

A/N, skip if blank 

1 

1 

Card 4 (Storage Subsystem) 
Transaction Code 

Always 'D' 

2 

2 

Card Code 

Always '04' 

4 

4 

Subsystem 

From cols. 15-18 of card 1 

8 

2 

ID 

A/N, LJ, skip if blank 


2 

Type 

A/N, LJ, skip if blank 


2 

Constercial ID 

A/M, LJ, skip if blank 

14 

10 

Dimension 

1 A/N, LJ, skip if blank 


14 


10 


Dimension 
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JOB NUMBER. 

NAME; Subsystem Evaluation Input Sheet 


CARO COL. 


NO. OF COL'S 


FIELD DESCRIPTION 


24 

26 

30 

34 

42 

46 


1 

9 

4 

8 

10 

12 

14 

16 


1 

2 

4 

8 

'0 

12 

14 


2 

4 

4 

4 

4 

34 


1 

2 

4 

2 

2 

2 

2 

64 


1 

2 

4 

2 

2 

2 


Card 4 (Storage Subsystem 
Conti nuedT 

Thermal Cap 

Rated Temperature 

Rated Pressure 

Burst Pressure 

Rated Range 

Performance Data 

Card 5 (Cooling Subsystem) 
Transaction Code 
Card Code 
Subsystem 
ID 

Material ID * > 

Fluid ID 
Safety Code 
Performance Data 

Card 6 (Heating Subsystem) 
Transaction Code 
Card Code 


Subsystem 

ID 

Material ID 
Type 

Conmercial ID 


OF POOR QTJAIOT 
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OF b 

, I ,m:\ - I,. ,,, .1. 

EFFECTIVE DATE. 


SPECIAL INSTRUCTIONS 


A/N, LJ, skip if blank 

A/Ns LJ, skip if blank 

A/N, LJ, skip if blank 

A/N, LJ, skip if blank 

A/N, LJ, skip if blank 

A/N, LJ, punch as shown 

Always 'O' 

Always '05* 

From cols. 15-18 of card 1 
A/N, LJ, skip if blank 

A/N, LJ, skip if blank 

A/N, LJ, skip if blank 

A/N, LJ, skip if blank 

A/N, LJ, punch as shown 

Always 'D' 

Always '06' 

From cols. 15-18 of card 1 
A/N, LJ, skip if blank 

-A/N, LJ, skip if blank 

A/N, LJ, skip if blank 

A/N, LJ, skip if blank 






KEYPUNCH OPERA iiNG INSTRUCTIONS 


PAGE 


4 


OF 


5 


JOB NUMBER. 


'-'’NAME; Subsystem Evaluation Input Sheet 


EFFECTIVE DATE: 


CARD COL, NO* OF COL’S 









FIELD DESCRIPTION 


Card 6 (Heating Subsystem 
Continued') 


SPECIAL INSTRUCTIONS 


Safety Code 
Performance Data 


Card 7 (Control Subsystem) 
Transaction Code 
Card Code 
Subsystem 


Logic ID 
Parameters 


Card 8 (Control Subsystem 
Co'iitinuedT ^ 

Transaction Code 

Card Code 

Subsystem 

Sensor Types 


Card 9 (Control Subsystem 
Continued) 

Transaction Code 

Card Code 

Subsystem 

Operating Modes 


A/N, LJ, skip ib blank 
A/N, LJ, punch as shown 


Always 'D' 
Always '07' 


From cols. 15-18 of card 1 


A/N, LJ, skip if blank 
A/N, LJ, skip if blank 
A/N, LJ, punch as shown 


Always 'D' 

Always '08' 

From cols. 15-18 of card 1 
A/N, LJ, punch as shown 


Always *D' 

Always '09' 

From cols. 15-18 of card 1 
A/M, LJ, punch as shown 
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JOB NUMBER. 

•'••’NAME; Subsystem Evaluation Input Sheet 




EFFECTIVE DATE; 


CARD COL. 


NO. OF COL'S 


FIELD OErCflIPTION 


SPECIAL INSTRUCTIONS 


1 

2 

4 

8 

10 

12 

14 

16 

18 


1 

2 

4 

2 

2 

2 

2 

2 

2 


Card 10 (Hot Water Subsystem) 
Transaction Code 
Card Code 
Subsystem 
ID 

Type 

Comnercial ID 

Fluid Interface Separation • 
Toxicity Potential 
Safety Standards 


Always 'D* 

Always '10' 

From cols. 15-18 of card 1 
A/N, LO, skip if blank 
A/N, LJ, skip if blank 
A/N, LJ, skip if blank 
A/N, LJ, skip if blank 
A/N, LJ, skip if blank 
A/N, LJ, skip if blank 



9.0 GDPS REQUEST GOORSINATOR GUIDELINES 


The GDPS Request Coordii ator is the focal point for the processing of requests 
for GDPS services. He provides the following; 

(1) External User Interface 

(2) Perfoirmance Analyst Interface 

(3) GDPS Software Change Coordination 

(4) Data Base Contents and Security 

9 . 1 APPLICABLE DOCUMEHTS 


The following documents are considered pertinent to the request coordinator's 
functions ; 

(1) CDPS Software Performance Specification Document 

(2) CDPS Software Design Document 

(3) MSEC Data System Plan 

(4) Solar Heating and Cooling Instrumentation and Installation 
Guidelines 

(5) SDAS Performance Specification 

(6) NIPS User Manuals 

9.2 EXTERNAL USER INTERFACE 


The External User (outside IBM and MSFC) will request CDPS services via the 
appropriate government agency for which he is performing tasks to ERDA. These 
requests will be forwarded to MSFC for evaluation and action by IBM. The request 
coordinator will handle all interface for CDPS services and will provide resulting 
data to MSFC for transmittal to the user requesting the data. 

9.3 PERFORMANCE ANALYST INTERFACES 


Performance Analyst input requests for remote sits initiation, site description 
changes, site deletion, and special processing will be coordinated and accomplished 
through the request coordinator. The coordinator will ensure that proper authority 
exists for all changes to the remote site definition and will review all results of 
CDPS processing to ensure that requests have been fully satisfied. 
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9.4 GDPS SOFTWARE CHANGES 


All changes to the GDPS software resulting from either new requirements or 
correction of software deficiencies will be formally controlled. The coordinator 
will provide the interface through which changes are requested and implemented. 

9.5’ DATA BASE CONTENTS AND SECURITY 


The request coordinator will control access to the performance evaluation 
data base^ and will provide training to personnel authorized to access the data 
base. In addition) all data entered into the data base (other than instrumentation 
data) will be coordinated through the request coordinator. 


APPENDIX A 

USER’S MANUAL FOR PLOT CAPABILITY 


A-1 


1.0 imODUCTION 


This manual is intended to assist the user in exercising the steps necessary to 
generate plots on a Tektronix display tezmlnal using the NIPS software package. 
The user must be familiar with the NIPS Terminal Processing (TP) capability. 

The hardware components which are used in conjunction with NIPS are: 

(1) The IBM 3277 Display Unit 

(2) The Tektronix 4015-1 Display Unit 

The IBM 3277 will be used for NIPS software application and the Tektronix for 
graphics. 

In order to present the user with an overview of the complete process involved 
in generating plots, a functional flow illustrated in Figure A will be discussed. 

(1) Using NIPS and the NIPS TP, an information retrievable query is made by 
addressing and updating a RIT data file. This causes selected parameters 
baaed on a. particular site and date to be abstracted from a NIPS data base. 
These parameters are then stored (RETR DATA BASE) for subsequent recall to 
be plotted. A detailed description and use of the RIT data file is con- 
tained in Section 2.1. 

(2) Finally, using the NIPS TP, a joo is submitted from the 3277 terminal to 
the host computer which will: 

o Address the RETR data base and reformat the DATA. 

o Pass the plot information to a Tektronix display for plot generation. 

A detailed description of the steps necessary to submit a job using NIPS TP and 
the 3277 terminal is contained in Section 3.0. 
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2.0 FILE FOEMAT 


2.1 RIT DATA FILES 

There is basically one file format that the user must be familiar with, i.e., 
the RIT data file. The purpose of this data file is to give the user flexibi- 
lity in specifying: 

o The site from which the variable/variables are to be selected 
0 The recording date for the variable/variables. 

To accommodate all the predefined variables to be plotted, each variable or 
variables (in the case of multiple plots) will have assigned to it a unique RIT 
data file. This permits the user to select beforehand the variables to be 
plotted. 

The format of this file is illustrated in Figure B and defined as follows: 

Line Function/ Remarks 

1-10 Defines the control information necessary to retrieve selected data. 

The user under normal operation will not modify these lines because 
they will be unique for a given parameter to be retrieved from the 
NIPS data base, 

11 Defines the site (AAAAA) and the recording period (BB3BBB) specified 

by the user for the variables to be plotted. 

From the preceding definition and referring again to Figure B we see that, if 
the user requested Site 3 and a recording date of September 1, 1976, line 11 
would be modified as follows: 

PUBLISH SPECIAL = PLOTOl PARA.M=1000C3760901 


A-4 


I 


(1) CREATE RITID=PL0T01 STORE=TEMP | 

(2) FILE HOURLY 

(3) FORMAT TAPE NAME PLOTOl 

(4) REGORDl IF RDATE EQ PARAM 7/12 AND ROSID EQ PARAM 2/6 

(5) RECORDl 12 PARAM 1/12 

(6) RECORD2 IF RDATE EQ PARAM 7/12 AND ROSID EQ PARAM 2/6 

(7) RECORD 2 7 Nlll 

(8) RECORD 2 2 '01’ 

(9) END 

(10) SOURCE DIRECT 

(11) PUBLISH SPECIAL=PL0T01 PARAM= ' lAAAAABBBBBB ’ 

Figure B. RIT Data File Format 

2.2 UNIQUE RIT DATA FILES 

As discussed in Section 2,1, each variable to be plotted will have its own RIT 
data file. The user need only know the variable required and its RIT data file 
identification to attain the requested plot. 

Each RIT data file will be stored with its associated identifier for immediate 
recall. At the present time no standard plots have been defined, but for pur- 
poses of illustration, the following could be an example. 


IDENTIFIER 

VARIABLE 

TITLE 

PLOTl 

Nlll 

'ECSS CON £FF’ 

PL0T2 

N113 

* 

'.AVG AMB DB T’ 

PLOT26 

« 

Q604 

• 

'TOT E ENRG SAV 


NOTE: The ordinate for the predefined plots is designated by the column en- 

titled 'TITLE* and the abscissa defaults to 'TIME IN HRS’ in 24 hourly incre- 
ments. The implementation of this predefined table will be discussed in 
Section 3.0. 
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3.0 NIPS TERMINAL PROCESSOR (TP) REMOTE JOB EXECUTION 


Through Che NIPS TP, certain commands must be exercised in order to update a 
RIT data file and/or submit a job remotely for execution on the host computer. 

The following paragraphs will discuss these commands and their resultant actions. 


Note: Symbol 


Meaning 


^ Start Key, Terminal Input 

0 Entry Key, End of Terminal Input 

© Response from NIPS TP 


(1) ►LOGON AQUILA 7R!3 

(2) ^/G MEM=PL0T1 LIB=NIPPLOT 7E0 
©EOM RECEIVED 

EDIT PROCES'' COMPLETED. START CONVERSATION. 

(3) ►SB 

©OUTPUT QUEUE SCRATCHED. CONVERSATION TERMINATED. 

(4) ^730 

©QUERY DELETED, 

(5) ►/C llO/lAAAAABBBBBB/100004760102/ 

©EOM RECEIVED. 

©EDIT PROCESS COMPLETED. START CONVERSATION. 

(6) ►SB 

©OUTPUT QUEUE SCRATCHED. CONVERSATION TERMINATED. 

(7) ►ISS 

©QUERY DELETED. 


The preceding terminal inputs to update the RIT data file are explained as 
follows. 


Function/Remarks 


This NIPS TP Command Initiates the terminal session. 

This NIPS TP Command brings into the NIPS TP work file the PDS member 
PLOTl. This member contains the RIT data file and the necessary job 
control language for the plot generation of Variable Nlll. (See 
Section 2,2). 

These NIPS TP Commands must be entered before another NIPS TP Command 
is issued. 

This NIPS TP Command updates the RIT data file (Section 2.1). This 
changes the line with sequence number 110 (Figure B) in the NIPS TP 
work file such that PARAM= ' lAAAAABBBBBB ' becomes PARAM=’ 100004760102 ' . 
This will cause parameter Nlll recorded on January 2, 1976 from Site 
4 to be retrieved and stored for plotting. 

These NIPS TP Commands terminate the previous NIPS TP Command. 
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4.0 EXAMPLES 


The following terminal session was used to generate a single plot on the 4015 
Tektronix terminal. 

Note: Symbol 

► 

B 
© 

(1) ^ LOGON AQUILA 7RB 

(2) ► /G MEM=PL0T1 LIB=NIPPLOT 7EB 
© EOM RECEIVED 

©EDIT PROCESS COMPLETED. START CONVERSATION. 

(3) ►SB 

©OUTPUT QUEUE SCRATCHED. CONVERSATION TERMINATED. 

(4) ► 7SB 
© QUERY DELETED. 

(5) ► /C 110/1AAAAABBB3BB/100003760901/ 

© EOM RECEIVED. 

©EDIT PROCESS COMPLETED. CONVERSATION TERMINATED. 

(6) ► SB 

©OUTPUT QUEUE SCRATCHED. CONVERSATION TERMINATED. 

(7) ► 7SB 
© QUERY DELETED. 

(8) ► /SUBMIT 7EB 
© EOM RECEIV1H> 

©EDIT PROCESS COMPLETED. CONVERSATION TER>IINATED. 

(9) ►LOGOFF 7RQ 


Meaning 

Start Key, Start of Terminal Input 
Entry Key, End of Terminal Input 
Response from NIPS TP 


Line 


Functlon/'ResuIts 


1 This NIPS TP Command initiates the terminal session. 

2 This NIPS TP Command brings into the TP work file the PDS member 
PLOTl, This member contains the RIT data file and the necessary job 
control language for the plot generation of Variable Nlll (see Sec- 
tion 2.2) . 

3-4 These NIPS TP Commands must be entered before another NIPS TP Command 

is issued. 

5 This NIPS TP Command updates the RIT data file (Section 2.1). This 

changes the line with Sequence Number 116 (Figure B) in the NIPS TP 
work file such that PARAM= ' lAAAAABBBBBB ' becomes PASAM= ’ 100003760901 ' . 

This will cause parameter Nlll recorded on September 1, 1976 from Site 
3 to be retrieved and stored for plotting. 

6-7 These NIPS TP Commands must be entered before another NIPS TP Command 

is issued. 

8 This NIPS TP Command submits the contents of the NIPS work file for 
execution by the host computer. 

9 This NIPS T? Command terminates the terminal session. 

The output from this terminal session is illustrated in Figures C and D. 
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